Stepper
Where a person is in a flow of steps, such as a checkout or a setup. When the current step moves, the lines between fill one after another and the ring travels to its new step.
Examples
Default
A checkout with Back and Continue. Continue: the line fills and the ring moves on; pick a step already done to go back to it.
Vertical
orientation="vertical" stacks the steps, as the Timeline does. An optional step says so in its description.
Error
status="error" marks a step that needs another look, with a mark of its own. Try again clears it and moves on.
Links
Steps that are pages render as links, and linear={false} lets every step be picked in any order.
Shown only
Without StepperTrigger, the stepper only shows where things are, such as an import that runs on its own.
Installation
npx shadcn@latest add https://kinoui.com/r/stepper.json- Files
lib/reduce-motion.tslib/step.tslib/resize.tslib/choice.tslib/refs.tscomponents/kino/stepper.tsx- Packages
@base-ui/react- Global CSS
- the feels, the density tokens, the shape tokens and the success and warning colours
New to Kino? Installation covers what your project needs first and the @kino namespace.
API reference
Stepper
StepperItem
Data attributes
CSS variables
Accessibility
- The stepper is an ordered list, not a tab list: an upcoming step in a linear flow can’t be reached, so there are no panels to switch. Name it with
aria-labeloraria-labelledby, and put it in a<nav>when its steps are links. - The current step is
aria-current="step", on its trigger when it has one. The others read their status before their title: “Completed”, “Upcoming” or “Error”. - Done and error steps show a tick and an exclamation mark, and the current marker takes an outline in forced colours, so the status never relies on colour.
- Triggers are buttons or links in the tab order; a disabled one leaves it. Markers and lines are hidden from screen readers.
- When the step changes, say so in a
role="status"region, such as “Step 2 of 4: Billing details”, as the examples do. - When the system asks for less motion, lines fill and markers change at once.