Skip to main content

Timeline

BasicData display<co-timeline>

Timeline lists the steps of a prior authorization, referral or claim in order, with done, current, pending and failed states.

import { Timeline } from 'health-components';

Examples​

Denied​

Storybook

Usage​

<Timeline items={[{ title: "Submitted", time: "10/01/2026", by: "Sam Patel", status: "done", tag: "Submitted" }, { title: "In Review", status: "current" }]} />

When to use​

  • Status history: PA Submitted, In Review, Pended, Approved.

When not to use​

  • Free-form activity feeds with many actors: a table.

Variants and states​

VariantWhat it is
doneGreen dot with check.
currentRinged primary dot, aria-current step.
pendingHollow dot, muted title.
failedRed dot with x.
tagStatusTag next to the title.

Accessibility​

  • Ordered list; the current step has aria-current="step".
  • Each state also has a different icon or fill.

Do and don't​

  • Do: Show who acted: "Payer (Availity 278)".
  • Don't: Reverse order without saying so.

Props​

PropTypeDefaultDescription
items *ReadonlyArray<TimelineItem>—Steps in order. Required

Also accepts native attributes, including defaultChecked, defaultValue, autoFocus, plus className and event handlers on the root element.

Angular, Vue and HTML​

Register the elements once (Angular guide), then use <co-timeline>. Attributes take strings; arrays and objects are set as properties (Angular [prop], Vue :prop) or as JSON attributes. Callbacks are DOM events with the value in event.detail.

Angular template
<co-timeline default-checked auto-focus [items]="items"></co-timeline>
KindNameDescription
property / JSON attributeitemsSteps in order. Required
attributedefault-checked / defaultChecked
property / JSON attributedefault-value / defaultValue
attributeauto-focus / autoFocus