Wizard
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) | tablist, tab e tabpanel (como no core) |
| Elemento HTML | <div role="tablist"> com <button role="tab" aria-labelledby aria-description> e painéis role="tabpanel" |
| Classe / componente | br-wizard |
| Origem | Veio da documentação do DS gov.br, completada onde faltava. |
Documentação oficial: gov.br/ds.
Nome acessível
O texto de cada passo; o core acrescenta aria-description="Passo N". O painel é nomeado pela aba. Exemplo: Passo 2: Endereço.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}, guia, {posicao} de {total}{estado}
Estados
Passo atual
- No código:
aria-selected="true" - Acrescenta ao anúncio: selecionada
Passo concluído
- No código:
texto acessível "concluído", 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 entre o passo ativo, o conteúdo do painel e os botões Voltar/Avançar |
| ← / → | Movem entre os passos (padrão de abas) |
| Enter ou Espaço | Ativa o passo ou botão em foco |
Para o desenvolvimento
br-wizard (V3). O core usa role="tablist"/"tab"/"tabpanel", tabindex="0" nos painéis e aria-description="Passo N". A confirmar: aria-description é recente e o suporte varia entre leitores; garanta que "Passo N de M" também esteja no texto. Ao avançar, mova o foco para o título do novo passo.
Fontes
- DS gov.br V3 · @govbr-ds/core — Wizard (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Tabs Pattern
- W3C WAI-ARIA APG · WAI-ARIA 1.2 — aria-description
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.