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/completestates 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
| Prop | Type | Default | Description |
|---|---|---|---|
items | array | - | Array of step objects. Each object has a title heading, an HTML content body, and an optional state field that controls indicator styling. |
title_tag | Enum: strong, h2, h3, h4, h5, h6 | h3 | Tag used for each step title. |
classes | array | - | Additional CSS class words merged into the root element. |
attributes | object | - | Additional HTML attributes spread on the root element. |
Classes
| Class | Capability | Default | Description |
|---|---|---|---|
.subtle | Emphasis | - | Lower emphasis; a muted, quieter weight. |
.neutral | Emphasis | Yes | Default emphasis; the standard weight at balanced contrast. |
.accent | Emphasis | - | Higher emphasis; a stronger, louder weight. |
.sm | Size | - | Small. |
.md | Size | Yes | Medium. |
.lg | Size | - | Large. |
.horizontal | Orientation | - | Children flow along the horizontal axis. |
.vertical | Orientation | Yes | Children 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
currentstate carriesaria-current="step", the ARIA token for the current step of a process.timelineenumerates dates rather than steps, so it marks its current entryaria-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
Related
- deflist - another typography pattern for structured content
- collection - for grids of content items (different purpose)