Playground

Stepper

Show progress through a numbered sequence of steps.

  • Built on native elements
  • An ordered list; the current step has aria-current="step".
  • Completed steps are marked in text for assistive tech, not by colour alone.
  • Styles in one file: 18-navigation.css

Import

import '@monoline/css';
import {Stepper} from '@monoline/react';

Not installed yet? Pick a route.

Copies the source and its styles into your project.

npx monoline add stepper

Usage

import {Stepper} from '@monoline/react';

<Stepper
  aria-label="Checkout"
  current={1}
  steps={[{title: 'Account'}, {title: 'Plan', description: 'Pick one'}, {title: 'Payment'}]}
/>

Examples

Checkout

Props

StepperProps

PropTypeDefaultDescription
steps requiredStepperStep[]–The steps in order, each with a `title` and optional `description`.
current requirednumber–Zero-based index of the current step. Earlier steps are done.

Data Attributes

State is exposed through attributes. Style it with these selectors, not with class toggles.

AttributeStylesheet
[aria-current="page"]18-navigation.css
[aria-current="step"]18-navigation.css
[aria-selected="true"]18-navigation.css
[data-state="done"]18-navigation.css

CSS classes

ClassStylesheet
.brand18-navigation.css
.crumbs18-navigation.css
.pager18-navigation.css
.step18-navigation.css
.steps18-navigation.css
.tab18-navigation.css
.tabpanel18-navigation.css
.topbar18-navigation.css
.topbar-nav18-navigation.css

Customization

Style it with the kit's tokens in your own CSS, loaded after @monoline/css. Prefer the attributes above over extra classes. See Theming for every token.

app.css
.brand {
  border-color: var(--accent);
}
.brand[aria-current="page"] {
  background: var(--wash);
}

Accessibility

  • An ordered list; the current step has aria-current="step".
  • Completed steps are marked in text for assistive tech, not by colour alone.