Stepper
Navigation
stable
Visual progress indicator that guides the user through a numbered sequence of steps, supporting horizontal and vertical orientations.
API
Props
All props accepted by this component, with their type, default value and description.
- itemsIStepperItem[]
- Array of step descriptors. Each item has title, optional subtitle, icon and status.
- modelValuenumber0
- Index (0-based) of the currently active step. Bind with v-model.
- orientation'horizontal' | 'vertical''horizontal'
- Layout direction of the step indicators.
- clickablebooleanfalse
- When true, clicking a step indicator navigates to that step.
- showConnectorsbooleantrue
- Shows a connecting line between step indicators.
- idstring
- classstring | Array<string> | object
- stylestring | Array<string> | object | StyleValue
- colorTColor
- Active-step accent color. Accepts semantic intents or a CSS color.
- bgColorTColor
- sizeTSize | number'default'
- Controls the indicator circle size and font sizes.
- densityTDensity'default'
- Adjusts block padding between the stepper wrapper and its items.
- heightnumber | string
- Overrides the stepper container height.
- maxHeightnumber | string
- maxWidthnumber | string
- minHeightnumber | string
- minWidthnumber | string
- widthnumber | string
- Overrides the stepper container width.
- elevationTElevation
- Box-shadow elevation token for the stepper container.
- marginboolean | number | string
- marginTopboolean | number | string
- marginLeftboolean | number | string
- marginBottomboolean | number | string
- marginRightboolean | number | string
- marginBlockboolean | number | string
- marginInlineboolean | number | string
- marginInlineStartboolean | number | string
- marginInlineEndboolean | number | string
- marginBlockStartboolean | number | string
- marginBlockEndboolean | number | string
- paddingboolean | number | string
- paddingTopboolean | number | string
- paddingLeftboolean | number | string
- paddingBottomboolean | number | string
- paddingRightboolean | number | string
- paddingBlockboolean | number | string
- paddingInlineboolean | number | string
- paddingInlineStartboolean | number | string
- paddingInlineEndboolean | number | string
- paddingBlockStartboolean | number | string
- paddingBlockEndboolean | number | string
- roundedboolean | number | string | TRounded | null | undefined
- Border-radius token for the stepper container.
- roundedTopRightboolean | number | string
- roundedTopLeftboolean | number | string
- roundedBottomLeftboolean | number | string
- roundedBottomRightboolean | number | string
- roundedStartStartboolean | number | string
- roundedStartEndboolean | number | string
- roundedEndStartboolean | number | string
- roundedEndEndboolean | number | string
- borderboolean | number | string | TDirectionBoth | Array<TDirectionBoth>false
- Applies a border to the stepper container.
- borderTopboolean | number | string
- borderLeftboolean | number | string
- borderBottomboolean | number | string
- borderRightboolean | number | string
- borderBlockboolean | number | string
- borderInlineboolean | number | string
- borderInlineStartboolean | number | string
- borderInlineEndboolean | number | string
- borderBlockStartboolean | number | string
- borderBlockEndboolean | number | string
- borderColorstring
- borderStylestring
- borderTopColorTColor
- borderRightColorTColor
- borderBottomColorTColor
- borderLeftColorTColor
- borderInlineStartColorTColor
- borderInlineEndColorTColor
- borderBlockStartColorTColor
- borderBlockEndColorTColor
API
Slots
Content slots exposed by this component.
- #default
- Custom step items. When provided, the items prop is ignored.
API
Emits
Events emitted by this component.
- @update:modelValuenumber
- Fired when the active step changes. Bind with v-model.
Interactive
Playground
Edit props live and see the component update in real time. The generated code snippet updates as you change values.
Rendering the live preview…
Usage
Examples
Ready-to-paste code snippets for your templates.
Basic stepper
Vertical orientation
Clickable steps
Ecosystem
Family
Components from the same folder that share conventions and often compose together.