Step
Nenhuma fonte cobre tudo deste componente: o ponto em aberto está na seção "Para o desenvolvimento". Se você testou na implementação, conte o que viu nos comentários.
| Versões do DS | V3 |
| Papel (role) | listbox com option (como no core) — ver nota |
| Elemento HTML | <div role="listbox" aria-orientation aria-label="Lista de passos"> com <button role="option"> |
| Classe / componente | br-step |
| Origem | Veio da documentação do DS gov.br, completada onde faltava. |
Documentação oficial: gov.br/ds.
Nome acessível
O texto do passo (rótulo visível); a lista leva aria-label ("Lista de passos"). Exemplo: Dados pessoais.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}, opção, {posicao} de {total}{estado}
Estados
Passo atual
- No código:
aria-selected="true" (no padrão listbox) ou aria-current="step" - Acrescenta ao anúncio: passo atual
Concluído
- No código:
texto "concluído" acessível, não só ícone/cor - Acrescenta ao anúncio: concluído
Desabilitado
- No código:
aria-disabled="true" - Acrescenta ao anúncio: indisponível
Teclado
| Tecla | O que faz |
|---|---|
| Tab / Shift+Tab | Move o foco para os passos acionáveis |
| Setas | Movem entre os passos, se o componente usar o padrão listbox |
| Enter ou Espaço | Ativa o passo em foco, quando navegável |
Para o desenvolvimento
br-step (V3). O código do core usa role="listbox" na trilha e role="option" nos botões, com aria-posinset e aria-setsize (e aria-orientation). A confirmar: listbox implica seleção e setas, o que combina mal com a trilha de progresso; para só indicar progresso, o mais simples é uma lista (<ol>) com aria-current="step" no passo atual. Defina com o time de desenvolvimento.
Fontes
- DS gov.br V3 · @govbr-ds/core — Step (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Listbox Pattern
- W3C WAI-ARIA APG · WAI-ARIA 1.2 — aria-current
Comentários e evolução
Viu algo a corrigir ou completar nesta especificação? Comente abaixo dizendo qual parte, o que mudar e a fonte (WCAG, eMAG, WAI-ARIA APG, documentação do DS gov.br ou teste com leitor de tela). É preciso uma conta no GitHub. As sugestões aceitas entram na base e aparecem nas Novidades.