Pular para o conteúdo principal

Wizard

A confirmar

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 DSV3
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 / componentebr-wizard
OrigemVeio 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}

Comportamento esperado, não a fala exata: NVDA, JAWS, VoiceOver e TalkBack variam. No plugin, cada elemento tem um campo para o resultado do teste com leitor de tela real.

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​

TeclaO que faz
Tab / Shift+TabMove 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çoAtiva o passo ou botão em foco
Fonte: curadoria (WAI-ARIA APG).

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​

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.