Pular para o conteúdo principal

Item

Versões do DSV3
Papel (role)listitem (dentro de br-list) · link ou button quando interativo
Elemento HTML<li>, <a> ou <button>
Classe / componentebr-item
OrigemA documentação do DS não cobre o essencial: completado pela curadoria com o padrão do W3C (WAI-ARIA APG) e o eMAG.

Documentação oficial: gov.br/ds.

Nome acessível​

O texto do item. Item só com ícone ou ação precisa de aria-label (o exemplo do core usa um aria-label descritivo). Exemplo: Meus pedidos.

O que é anunciado​

Esperado conforme o padrão (WAI-ARIA APG): {nome}, {posicao} de {total}; {nome}, link{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​

Selecionado / atual​

  • No código: aria-current ou aria-selected conforme o contêiner
  • Acrescenta ao anúncio: selecionado

Desabilitado​

  • No código: aria-disabled="true"
  • Acrescenta ao anúncio: indisponível

Teclado​

TeclaO que faz
EnterAtiva o controle em foco
EspaçoAtiva botões e alterna controles
Tab / Shift+TabMove o foco para o controle seguinte / anterior
Fonte: curadoria (WAI-ARIA APG).

Para o desenvolvimento​

br-item (V3), bloco usado em listas, menus e dropdowns; o papel depende do contêiner (lista, menu, navegação). O item não tem anúncio próprio: o papel vem do elemento HTML usado (<a>, <button>, <li>).

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.