Flujo de trabajoAlea Pro
RoadmapTimeline y CycleProgress
Proyectos en una línea de tiempo con su progreso y el día de hoy marcado, y un ciclo de un vistazo: alcance, iniciado y hecho día a día.
import { RoadmapTimeline, CycleProgress } from '@alea/pro';
Ejemplos
Roadmap
Proyectos de inicio a fin con su progreso, los meses arriba y el día de hoy marcado.
Ciclo
Alcance, iniciado y hecho cada día de un ciclo de dos semanas, los números arriba y la línea objetivo punteada.
- Scope
- 26
- En curso
- 21
- Hecho
- 16 (62% hecho)
| Day | Scope | En curso | Hecho |
|---|---|---|---|
| 9 oct | 22 | 3 | 0 |
| 10 oct | 23 | 5 | 1 |
| 11 oct | 24 | 7 | 3 |
| 12 oct | 25 | 9 | 5 |
| 13 oct | 26 | 11 | 7 |
| 14 oct | 26 | 13 | 9 |
| 15 oct | 26 | 15 | 10 |
| 16 oct | 26 | 17 | 12 |
| 17 oct | 26 | 19 | 14 |
| 18 oct | 26 | 21 | 16 |
Tokens
Los tokens de diseño que usa este componente, con su valor en el tema actual. Cambia cualquiera para darle otro estilo.
Color
--alea-border…--alea-status-danger…--alea-surface…--alea-text…--alea-text-muted…
Radius
--alea-radius-md…--alea-radius-sm…
Type
--alea-font-size-xs…--alea-font-weight-medium…--alea-font-weight-regular…
Motion
--alea-motion-duration-fast…--alea-motion-duration-slow…--alea-motion-ease-out…
Props
RoadmapTimeline props
Proyectos en una línea de tiempo: una barra de inicio a fin con su progreso, los meses arriba y una línea para hoy. Cada proyecto es un elemento de lista que dice sus fechas y su progreso en palabras.
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
itemsobligatoria | RoadmapItem[] | - | Los proyectos: nombre, inicio, fin y, opcionales, progreso, estado y href. |
aria-label | string | - | Nombre del roadmap. |
className | string | - | Clases extra para el elemento raíz. |
from | Date | - | Primer y último día visibles. Por defecto: del inicio más temprano al final más tardío, por meses completos. |
showToday | boolean | true | Marca el día de hoy. Por defecto true. |
to | Date | - | Último día que se muestra. Por defecto el fin del mes del último fin. |
CycleProgress props
Un ciclo de un vistazo: cuánto hay en alcance, iniciado y hecho cada día, y dónde está ahora. El gráfico es una imagen; los números están en el texto y en una tabla para lectores de pantalla.
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
daysobligatoria | { scope: number; started: number; completed: number; }[] | - | Por día desde el inicio: alcance total, iniciado y completado (cantidades o puntos). |
endobligatoria | Date | - | Último día del ciclo. |
nameobligatoria | string | - | El nombre del ciclo: "Cycle 144". |
startobligatoria | Date | - | Primer día del ciclo. |
className | string | - | Clases extra para el elemento raíz. |
Especificaciones
Generado desde el código: las variantes de los tipos, los estados y tokens del CSS, y los patrones de motion que aplican. Las grillas muestran el componente real en ambos temas; los números se miden en la página.
RoadmapTimeline
- Estados
- Hover (CSS)
- Oscuro y claro
- Cada color viene de tokens del tema, así que sigue a data-theme (y a presets como Graphite) en la página o en cualquier contenedor. El contraste se revisa en ambos temas.
- Clases para estilos
.alea-roadmap.alea-roadmap-months.alea-roadmap-rows.alea-roadmap-row.alea-roadmap-bar.alea-roadmap-fill.alea-roadmap-name.alea-roadmap-lead.alea-roadmap-today.alea-roadmap-grid
CycleProgress
- Oscuro y claro
- Cada color viene de tokens del tema, así que sigue a data-theme (y a presets como Graphite) en la página o en cualquier contenedor. El contraste se revisa en ambos temas.
- Clases para estilos
.alea-cycle.alea-cycle-head.alea-cycle-name.alea-cycle-dates.alea-cycle-stats.alea-cycle-chart.alea-cycle-area.alea-cycle-line.alea-cycle-target- Atributos data
data-k=starteddata-k=completed
Accesibilidad
- Cada proyecto es un elemento de lista que dice su nombre, fechas y progreso en palabras; las barras son la imagen.
- El gráfico del ciclo es decorativo; sus números están en el texto de arriba y en una tabla para lectores de pantalla.
Teclado
| Tecla | Acción |
|---|---|
| Tab | Recorre los proyectos que llevan a algún lado |
Qué hacer y qué evitar
Hacer
- Limita el roadmap a los proyectos que importan este trimestre.
- Muestra la línea de alcance del ciclo para que se vea el trabajo agregado.
Evitar
- No uses solo el color de la barra para decir que un proyecto va tarde: dilo en el nombre o en una etiqueta.
En Figma
RoadmapBar con Progress y CycleProgress con las tres series.