MarsalaDS

Buscar

Páginas e componentes da documentação

Stepper

Uso

Indica progresso em fluxos sequenciais (checkout, cadastro). Stepper + StepperList + StepperItem; value 0-based; passos concluídos, atual e pendentes.

Quando usar

  • Padrão navigationMode sequential — avance com botões no formulário.
  • navigationMode free + onValueChange para clicar em 1, 2, 3 e saltar etapas.
  • orientation horizontal (padrão) ou vertical.
  • title e description opcional em cada StepperItem.

Evite quando

  • Não use para navegação livre entre abas — Tabs.
  • Evite dezenas de passos — divida o fluxo.

Instalação

Com o namespace @youxgroup configurado em components.json (veja Instalação).

pnpm dlx shadcn@latest add @youxgroup/stepper

Exemplos

Variações comuns de uso.

Horizontal

Vertical

Com botões (padrão)

Padrão: só os botões mudam a etapa (passos não são clicáveis).

Clicável nos passos

Clique no número de cada passo ou use Anterior / Próximo.

Marsala Design System