Stepper

Navigation
stable

Visual progress indicator that guides the user through a numbered sequence of steps, supporting horizontal and vertical orientations.

API

Props

Toutes les props acceptées par ce composant, avec leur type, valeur par défaut et description.

items
IStepperItem[]
Array of step descriptors. Each item has title, optional subtitle, icon and status.
modelValue
number
0
Index (0-based) of the currently active step. Bind with v-model.
orientation
'horizontal' | 'vertical'
'horizontal'
Layout direction of the step indicators.
clickable
boolean
false
When true, clicking a step indicator navigates to that step.
showConnectors
boolean
true
Shows a connecting line between step indicators.
id
string
class
string | Array<string> | object
style
string | Array<string> | object | StyleValue
color
TColor
Active-step accent color. Accepts semantic intents or a CSS color.
bgColor
TColor
size
TSize | number
'default'
Controls the indicator circle size and font sizes.
density
TDensity
'default'
Adjusts block padding between the stepper wrapper and its items.
height
number | string
Overrides the stepper container height.
maxHeight
number | string
maxWidth
number | string
minHeight
number | string
minWidth
number | string
width
number | string
Overrides the stepper container width.
elevation
TElevation
Box-shadow elevation token for the stepper container.
margin
boolean | number | string
marginTop
boolean | number | string
marginLeft
boolean | number | string
marginBottom
boolean | number | string
marginRight
boolean | number | string
marginBlock
boolean | number | string
marginInline
boolean | number | string
marginInlineStart
boolean | number | string
marginInlineEnd
boolean | number | string
marginBlockStart
boolean | number | string
marginBlockEnd
boolean | number | string
padding
boolean | number | string
paddingTop
boolean | number | string
paddingLeft
boolean | number | string
paddingBottom
boolean | number | string
paddingRight
boolean | number | string
paddingBlock
boolean | number | string
paddingInline
boolean | number | string
paddingInlineStart
boolean | number | string
paddingInlineEnd
boolean | number | string
paddingBlockStart
boolean | number | string
paddingBlockEnd
boolean | number | string
rounded
boolean | number | string | TRounded | null | undefined
Border-radius token for the stepper container.
roundedTopRight
boolean | number | string
roundedTopLeft
boolean | number | string
roundedBottomLeft
boolean | number | string
roundedBottomRight
boolean | number | string
roundedStartStart
boolean | number | string
roundedStartEnd
boolean | number | string
roundedEndStart
boolean | number | string
roundedEndEnd
boolean | number | string
border
boolean | number | string | TDirectionBoth | Array<TDirectionBoth>
false
Applies a border to the stepper container.
borderTop
boolean | number | string
borderLeft
boolean | number | string
borderBottom
boolean | number | string
borderRight
boolean | number | string
borderBlock
boolean | number | string
borderInline
boolean | number | string
borderInlineStart
boolean | number | string
borderInlineEnd
boolean | number | string
borderBlockStart
boolean | number | string
borderBlockEnd
boolean | number | string
borderColor
string
borderStyle
string
borderTopColor
TColor
borderRightColor
TColor
borderBottomColor
TColor
borderLeftColor
TColor
borderInlineStartColor
TColor
borderInlineEndColor
TColor
borderBlockStartColor
TColor
borderBlockEndColor
TColor

API

Slots

Emplacements de contenu exposés par ce composant.

#default
Custom step items. When provided, the items prop is ignored.

API

Emits

Événements émis par ce composant.

@update:modelValue
number
Fired when the active step changes. Bind with v-model.

Interactif

Playground

Modifiez les props en direct et observez le composant se mettre à jour. Le snippet de code généré suit vos changements.

Rendu de l’aperçu en cours…

Usage

Exemples

Extraits de code prêts à coller dans vos templates.

Basic stepper

vue

Vertical orientation

vue

Clickable steps

vue

Écosystème

Famille

Composants du même dossier qui partagent les conventions et se composent souvent ensemble.