Pular para o conteúdo principal

List

Versões do DSV3 e V4
Papel (role)list e listitem
Elemento HTML<ul>/<ol>/<dl> com <li>
Classe / componentebr-list
OrigemVeio da documentação do DS gov.br, completada onde faltava.

Documentação oficial: gov.br/ds · next-ds.

Nome acessível​

A lista não tem nome próprio; cada item é lido pelo conteúdo. Item interativo leva o nome do seu link ou botão. Dê aria-label à lista só se ela for um bloco de navegação ou precisar de contexto. Exemplo: Documentos do processo.

O que é anunciado​

Esperado conforme o padrão (WAI-ARIA APG): lista com {total} itens · {nome}, {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​

Expandido / recolhido​

  • No código: aria-expanded="true|false" no botão do item (aria-label "Expandir/Retrair …" como no core)
  • Acrescenta ao anúncio: expandido / recolhido

Item selecionado​

  • No código: aria-current ou checkbox/radio dentro do item
  • Acrescenta ao anúncio: selecionado

Teclado​

TeclaO que faz
TabNavega para o elemento interativo seguinte
Shift+TabNavega para o elemento interativo anterior
SetasMovem o foco entre os itens quando a lista é de seleção
Home e EndVão ao primeiro e ao último item quando a lista é de seleção
EnterAtiva o link ou a ação quando aplicável
EspaçoAtiva o Button ou alterna a seleção quando aplicável
Fonte: documentação do DS gov.br (V4).

Para o desenvolvimento​

br-list (V3) / <br-list> (V4). Prefira <ul>/<li> nativos; o exemplo do core usa role="list" e role="listitem" explícitos, necessários quando o CSS tira a semântica da lista (list-style: none em Safari/VoiceOver). Listas aninhadas mantêm a hierarquia.

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.