Skip to content
Kimenpre-v1documentation home
Color scheme

ki-timeline

Use ki-timeline for activity feeds, audit logs, run histories and order updates. Give the ordered list a label and put each event in a direct ki-timeline-item child.

Theme for this example
Color scheme for this example
Preview deploy failed
The runner timed out while compiling the web app.
Luis Perez merged fix/search-index
<ki-timeline label="Deployment activity">
<ki-timeline-item tone="danger" datetime="2024-11-19T10:42:00Z" details-label="Build log">
Preview deploy failed
<div slot="details">The runner timed out while compiling the web app.</div>
</ki-timeline-item>
<ki-timeline-item datetime="2024-11-19T10:41:00Z">
<ki-avatar slot="start" size="xs" initials="LP"></ki-avatar>
Luis Perez merged <code>fix/search-index</code>
</ki-timeline-item>
</ki-timeline>

Events appear newest first. Set order="oldest-first" to start with the earliest event. Equal dates keep their order in the markup, and entries with missing or invalid dates follow the dated entries.

Append new items as events arrive. After the initial list renders, additions within a short interval share one polite announcement. Write the event’s outcome in its text so the status is available along with its marker tone.

API reference

When to use: present chronological events with independently readable summaries, optional times and details, including new entries in a live feed.

When not to use: offer a selectable command list, control the current step of a task, or represent progress toward completion.

Properties & attributes

AttributePropertyTypeDefaultDescription
labellabelstring | undefined–Accessible name of the ordered list.
orderorder"newest-first" | "oldest-first"'newest-first'Chronological order of valid dates. Ties and undated entries retain source order. Undated entries follow valid dates in either direction.

Slots

SlotDescription
(default)Direct ki-timeline-item children.

CSS parts

PartDescription
announcementsPolite region for batches of new event summaries.
itemNative list entry including the connector to the next event.
listNamed native ordered list.

CSS custom properties

The public styling contract of ki-timeline: reassign these tokens at :root or on a subtree — never override internals.

TokenDescription
--ki-timeline-dot-sizeDiameter of the timeline marker.
--ki-timeline-gapSpace between marker and text and between timeline entries.
--ki-timeline-item-fgText color of the event summary and details.
--ki-timeline-lineColor of the decorative line connecting timeline markers.
--ki-timeline-line-widthHairline width of the timeline connector.
--ki-typography-family-bodysemantic font family for typography family body.
--ki-typography-visually-hidden-sizeNonzero edge for clipped text available to assistive technology.

Open ki-timeline in Storybook