Pular para o conteúdo principal

Step

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)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 / componentebr-step
OrigemVeio 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}

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" (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​

TeclaO que faz
Tab / Shift+TabMove o foco para os passos acionáveis
SetasMovem entre os passos, se o componente usar o padrão listbox
Enter ou EspaçoAtiva o passo em foco, quando navegável
Fonte: curadoria (WAI-ARIA APG).

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​

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.