Data display

Timeline

A vertical list of events in reading order, each with a marker, a title and a time.

Class nameTypeDescription
timelineplf:timelineComponentAn ordered list of events
timeline-groupplf:timeline-groupComponentGroups timelines under a title
timeline-group-titleplf:timeline-group-titlePartThe group's title
timeline-itemplf:timeline-itemPartOne event
timeline-markerplf:timeline-markerPartHolds an icon or avatar; a dot when empty
timeline-iconplf:timeline-iconPartAn SVG icon in the marker; an icon class there doesn't need it
timeline-contentplf:timeline-contentPartThe header, description and detail
timeline-headerplf:timeline-headerPartThe title and time
timeline-titleplf:timeline-titlePartThe event's title
timeline-timeplf:timeline-timePartA time element
timeline-descriptionplf:timeline-descriptionPartThe description
timeline-detailplf:timeline-detailPartExtra content, such as buttons
timeline-linkplf:timeline-linkPartA link in the text
timeline-marker-primaryplf:timeline-marker-primaryColorPrimary marker
timeline-marker-successplf:timeline-marker-successColorSuccess marker
timeline-marker-warningplf:timeline-marker-warningColorWarning marker
timeline-marker-errorplf:timeline-marker-errorColorError marker
timeline-marker-infoplf:timeline-marker-infoColorInfo marker
timeline-smplf:timeline-smSizeSmall

Default

Keep role="list", which Safari drops from a list styled without bullets. The time stays beside its title, which wraps, so keep it short: a time or a short date.

  1. Order placed

    Order #1024 · 3 items

  2. Payment confirmed

    Paid with Visa ending 4242.

  3. Packed and handed to the carrier

    Tracking number PLF-88213.

  4. Delivery

    Pending. You’ll get an email when it arrives.

Markers

A dot marker must be empty, without even whitespace.

  1. Icon

    An SVG icon.

  2. Avatar

    An Avatar fills the marker.

  3. Dot

    An empty marker.

Colors

Markers are decorative, so state each status in the title or description.

  1. Primary

    Primary marker.

  2. Success

    Success marker.

  3. Warning

    Warning marker.

  4. Error

    Error marker.

  5. Info

    Info marker.

  1. Version 2.4.0

    Timeline component and refreshed tokens.

  2. Version 2.3.1

    Fixes date picker focus clipping.

  3. Version 2.3.0

    Adds Multi Select Members.

  1. Version 2.4.0

    Timeline component and refreshed tokens.

  2. Version 2.3.1

    Fixes date picker focus clipping.

  3. Version 2.3.0

    Adds Multi Select Members.

Today

  1. Jordan Rivera commented on Q4 launch plan

    Let’s move the review to Thursday so finance can join.

  2. Amara Okafor uploaded Brand guidelines.pdf

    2.4 MB · Shared with Design

Yesterday

  1. Lena Fischer joined the workspace

    Invited by Jordan Rivera.

  1. Build started

    Triggered by a push to main.

  2. Checks passed

    128 tests in 3 minutes 41 seconds.

  3. Deployment failed

    The health check timed out on the production region.

    View logs

React

Timeline from @pelatform/react renders this list, role="list" included, and each part is a component of its own.

Prop Values Default
size sm The default size
color on TimelineMarker primary, success, warning, error, info Muted

The parts:

Part Element
TimelineItem An li with timeline-item
TimelineMarker A span with timeline-marker
TimelineContent A div with timeline-content
TimelineHeader A div with timeline-header
TimelineTitle A p with timeline-title
TimelineTime A time with timeline-time
TimelineDescription A p with timeline-description
TimelineDetail A div with timeline-detail
TimelineLink An a with timeline-link
TimelineGroup A div with timeline-group, which holds timelines under a TimelineGroupTitle
TimelineGroupTitle An h3 with timeline-group-title, or another heading with level

Other props are the element’s own, className and ref included.

CSS variables

Override on a root, a list or a single item; they win over the colors and the small size.

Variable Default
--plf-timeline-color Text
--plf-timeline-marker-size 2rem (32px); 1.5rem (24px) with timeline-sm
--plf-timeline-icon-size 1rem (16px); 0.875rem (14px) with timeline-sm
--plf-timeline-gap Space 6 (24px) between items; space 4 (16px) small
--plf-timeline-line-color --plf-color-border-subtle
--plf-timeline-marker-bg Surface; a color’s subtle background
--plf-timeline-marker-color Muted text; the color itself
--plf-timeline-marker-border --plf-color-border-subtle; the color’s border
--plf-timeline-time-color Muted text
--plf-timeline-description-color Muted text

Built with Pelatform UIv0.1.0

Components

Getting started

Foundations

Components

Actions

Data display

Navigation

Feedback

Data input

Layout

Advanced

Integrations

Blocks

Application

Authentication

Icons