Saltar al contenido
Alea0.1
Pro
  1. Alea
  2. Componentes
  3. Flujo de trabajo
  4. RoadmapTimeline y CycleProgress

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.

  • Mobile app 2.0, 4 ago - 20 nov, 70% hecho
  • Billing, 10 sept - 5 dic, 35% hecho
  • Agents in the inbox, 3 oct - 15 ene, 10% hecho
  • Accessibility pass, 1 sept - 25 oct, 90% hecho

Ciclo

Alcance, iniciado y hecho cada día de un ciclo de dos semanas, los números arriba y la línea objetivo punteada.

Cycle 1449 oct - 23 oct
Scope
26
En curso
21
Hecho
16 (62% hecho)
Cycle 144
DayScopeEn cursoHecho
9 oct2230
10 oct2351
11 oct2473
12 oct2595
13 oct26117
14 oct26139
15 oct261510
16 oct261712
17 oct261914
18 oct262116

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.

PropTipoPor defectoDescripción
itemsobligatoriaRoadmapItem[]-Los proyectos: nombre, inicio, fin y, opcionales, progreso, estado y href.
aria-labelstring-Nombre del roadmap.
classNamestring-Clases extra para el elemento raíz.
fromDate-Primer y último día visibles. Por defecto: del inicio más temprano al final más tardío, por meses completos.
showTodaybooleantrueMarca el día de hoy. Por defecto true.
toDate-Ú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.

PropTipoPor defectoDescripción
daysobligatoria{ scope: number; started: number; completed: number; }[]-Por día desde el inicio: alcance total, iniciado y completado (cantidades o puntos).
endobligatoriaDate-Último día del ciclo.
nameobligatoriastring-El nombre del ciclo: "Cycle 144".
startobligatoriaDate-Primer día del ciclo.
classNamestring-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

TeclaAcción
TabRecorre 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.

Probado con axe, teclado y roles de lector de pantalla