ki-timeline
@kimen/elements/ki-timeline- Source
- Agent reference
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.
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
| Attribute | Property | Type | Default | Description |
|---|---|---|---|---|
label | label | string | undefined | – | Accessible name of the ordered list. |
order | order | "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
| Slot | Description |
|---|---|
| (default) | Direct ki-timeline-item children. |
CSS parts
| Part | Description |
|---|---|
announcements | Polite region for batches of new event summaries. |
item | Native list entry including the connector to the next event. |
list | Named 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.
| Token | Description |
|---|---|
--ki-timeline-dot-size | Diameter of the timeline marker. |
--ki-timeline-gap | Space between marker and text and between timeline entries. |
--ki-timeline-item-fg | Text color of the event summary and details. |
--ki-timeline-line | Color of the decorative line connecting timeline markers. |
--ki-timeline-line-width | Hairline width of the timeline connector. |
--ki-typography-family-body | semantic font family for typography family body. |
--ki-typography-visually-hidden-size | Nonzero edge for clipped text available to assistive technology. |