Timeline
Shows events in a time-ordered sequence.
- Latest:
Design approved
Final layouts approved for the release.
Feedback addressed
Navigation and keyboard focus states updated.
Review requested
timeline-demo.tsx
Installation
The CLI adds the files, packages, theme variables, and Tailwind plugin that this component uses. Before you run it, set up your project.
npm
yarn
pnpm
bun
Composition
TimelineGive it an aria-label.
TimelineItemRepeatsTimelineTitleTimelineTimeSet dateTime.
TimelineDescriptionOptional
Process
Mark steps that have not happened with status="upcoming". The line to an upcoming step is dashed.
Order placed
Packed
- Latest:
In transit
The parcel left the Berlin sorting center.
- Upcoming:
Out for delivery
- Upcoming:
Delivered
timeline-process-demo.tsx
Icons
- Latest:
Version 2.4 deployed
Pull request merged
Adds keyboard reordering to tables.
Review comment
timeline-icons-demo.tsx
API reference
TimelineItem
- status: "complete" | "latest" | "upcoming" = "complete"
- Sets the marker. Screen readers announce "Latest" or "Upcoming" before the item.
- icon: ReactNode
- Replaces the check or dot in the marker. Use a 14 pixel icon.
TimelineTitle
- as: "h2" | "h3" | "h4" = "h3"
- Heading level for the event title.