Skip to main content

Steps

Numbered list of steps for "how to" editorial content. Static visual treatment - not a progress indicator for form wizards. Renders as an ordered list with numbered circles connected by a line, flowing vertically by default with an optional horizontal layout that collapses to vertical on mobile.

Usage​

When to use

  • "How to" editorial pages describing a sequence of actions
  • Application instructions, service guides, onboarding overviews
  • Any ordered set of self-contained steps that a reader follows once

When not to use

  • Multi-step form wizards or progress indicators - steps' pending/current/complete states are static, author-set markup values, not a JS-driven wizard engine with transitions
  • Unordered bullet lists - use a classless <ul> instead
  • Interactive step flows where each step is clickable as navigation - use a different component

Do

  • Use <ol> with a classless <h3> and <p> inside each <li>
  • Let CSS counters generate the numbered indicators
  • Pick a heading level that fits your page hierarchy

Don't

  • Use steps to represent wizard state (active, completed, upcoming)
  • Hard-code step numbers in the markup - CSS counters handle numbering
  • Nest interactive controls in the numbered indicator

API​

Props​

PropTypeDefaultDescription
itemsarray-Array of step objects. Each object has a title heading, an HTML content body, and an optional state field that controls indicator styling.
title_tagEnum: strong, h2, h3, h4, h5, h6h3Tag used for each step title.
classesarray-Additional CSS class words merged into the root element.
attributesobject-Additional HTML attributes spread on the root element.

Classes​

ClassCapabilityDefaultDescription
.subtleEmphasis-Lower emphasis; a muted, quieter weight.
.neutralEmphasisYesDefault emphasis; the standard weight at balanced contrast.
.accentEmphasis-Higher emphasis; a stronger, louder weight.
.smSize-Small.
.mdSizeYesMedium.
.lgSize-Large.
.horizontalOrientation-Children flow along the horizontal axis.
.verticalOrientationYesChildren flow along the vertical axis.

Examples​

Vertical​

Default vertical layout with indicators on the left, content on the right, and a line connecting them top-to-bottom.

Horizontal​

Horizontal layout with indicators on top and content below, collapsing to vertical on narrow viewports.

States​

All three progress words at once: two complete steps, the current one carrying aria-current="step", and one still pending.

Accessibility​

  • WCAG 2.2 AA
  • Native <ol> semantics - screen readers announce "list of N items" and provide numbered navigation
  • An item in the current state carries aria-current="step", the ARIA token for the current step of a process. timeline enumerates dates rather than steps, so it marks its current entry aria-current="date"
  • No other ARIA attributes required
  • Headings inside each step provide landmarks for screen reader navigation
  • Sufficient color contrast between indicator background and indicator text
  • The connecting line is purely decorative
  • deflist - another typography pattern for structured content
  • collection - for grids of content items (different purpose)