Timeline
Eventos en orden, vertical u horizontal, con indicadores, fechas y estado completado.
Project created
Repository initialised from the starter template.First deploy
Preview environment went live on the staging domain.Design review
Tokens and spacing approved by the design team.Public launch
Production release scheduled after QA sign-off.
Instalación
pnpm dlx nachui add timelineAnatomía
Cada item declara su
step. Los items cuyo step es menor o igual al value del timeline están completados: su indicador se rellena con el color primario y el separador que sale de ellos lo acompaña. El item en value además recibe data-active, así puedes darle estilo propio al paso actual. La raíz renderiza una lista ordenada y cada item un elemento de lista.Composición
Usa la siguiente composición para construir un
Timeline:Variantes
Horizontal
orientation="horizontal" distribuye los pasos de izquierda a derecha con la línea sobre el contenido. Los items reparten el ancho en partes iguales.Ordered
Packed
Shipped
Delivered
Íconos
Pasa un ícono como children del indicador y ajusta su tamaño con
className. Agrega padding al item para que el contenido no choque con el marcador más grande.Commit pushed
feat(ui): add a side-aware caret to the tooltipChecks passed
Lint, type-check and 312 tests in 48s.Merged into main
Squashed by lucia after one approval.Deployed
Waiting for the production rollout window.
Alternado
alternate refleja un item sí y otro no a cada lado de la línea, para roadmaps y páginas de historial.Discovery
Interviews with twelve teams and a first prototype.Private beta
Fifty workspaces onboarded behind a feature flag.General availability
Self-serve signup, billing and the public docs.Integrations
Slack, Linear and GitHub apps in the marketplace.
Fechas a la izquierda
Desplaza el item con un margen y posiciona la fecha en el canal libre. Las piezas son elementos simples, así que con un par de clases alcanza.
Ticket opened
Customer reported a broken checkout on Safari.Assigned to Nico
Escalated to the payments squad.Fix deployed
Patched the Apple Pay session handshake.Resolved
Customer confirmed the order went through.
Referencia de API
Timeline
| Prop | Type | Default | Description |
|---|---|---|---|
value | number | 1 | Los pasos menores o iguales a este valor están completados |
orientation | 'vertical' | 'horizontal' | 'vertical' | Dirección del layout |
alternate | boolean | false | Refleja un item de cada dos a través de la línea (vertical) |
className | string | - | Clases CSS adicionales |
Timeline.Item
| Prop | Type | Default | Description |
|---|---|---|---|
step | number | - | Posición del item, se compara contra value |
className | string | - | Clases CSS adicionales |
Expone
data-completed y data-active para estilos.Timeline.Title
| Prop | Type | Default | Description |
|---|---|---|---|
as | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'h3' | Nivel de encabezado |
className | string | - | Clases CSS adicionales |
Timeline.Date
Renderiza un elemento
time y acepta dateTime además de className.Timeline.Header, Timeline.Indicator, Timeline.Separator, Timeline.Content
Partes de layout de un item. Cada una acepta
className y las props estándar de div. El indicador acepta children para un marcador personalizado.¿Encontraste algo que mejorar?
¿Notaste un error, tipografía o detalle faltante en esta página? Ayúdanos a mejorar la documentación abriendo un issue en GitHub.