Stepper
Guide users through a sequence of panels and completion states.
Step 1: Set up your profile and login credentials.
Anatomy#
The indicator, label, and description share one trigger; separators appear only between items.
Usage#
Use Stepper to show progress through a fixed sequence of steps. Decide how far users may jump ahead
with navigation. Use Tabs for peer panels that are not a
sequence. Use Pagination for a result set with a known page count.
Navigation modes#
navigation (default 'none') controls which steps users can activate from their triggers:
noneenables only the active step, so the flow moves through your own controls.linearenables completed steps and the next step, so later steps stay locked until earlier ones are reached.freeenables every enabled step.
onValueChange fires only when the user activates a different step from a trigger, so in practice
only in linear and free. It does not fire for programmatic value changes. To drive the flow
from your own Previous and Next buttons, control value and update it in those handlers. Set
disabled on the Stepper to block every trigger.
Panels and orientation#
Step triggers and panels use tab semantics (tablist, tab, tabpanel). Every item requires a
unique value; an item that repeats an earlier value renders disabled and logs a development
warning. item.content is static JSX or a component that receives { value, index }; only the
active step’s panel renders, and a step without content has no panel. Vertical orientation changes
the layout and the arrow keys that move between steps. Stepper marks every step before the active
one as completed, based on item order. Set item.icon to replace the step number in the indicator.
Keyboard interaction#
activationMode controls whether arrow-key focus activates a step immediately (automatic, the
default) or only moves focus until ↵ or Space confirms it (manual).
Disabled and navigation-locked steps are skipped. Navigation stops at the first and last step unless
you set loop.
| Key | Description |
|---|---|
| → / ← | Moves to the next or previous enabled step in horizontal orientation. |
| ↓ / ↑ | Moves to the next or previous enabled step in vertical orientation. |
| ↖ / ↘ | Moves to the first or last enabled step. |
| ↵ / Space | Activates the focused step in manual activation mode. |
Examples#
Onboard with Previous and Next#
Keep the flow linear. Move between Account, Profile, and Review from application buttons.
One setup panel at a time#
Attach content to each step so only the active panel is shown.
Jump around a release workflow#
Control Draft, Review, and Ship from page state with the buttons below.
Compare navigation modes#
Choose a navigation mode to see which checkout steps can be activated.
API Reference#
Attributes#
data-disableddata-statedata-clickabledata-selectedProps#
Props for the Stepper component. Renders a <div> element by default.