List
| Versões do DS | V3 e V4 |
| Papel (role) | list e listitem |
| Elemento HTML | <ul>/<ol>/<dl> com <li> |
| Classe / componente | br-list |
| Origem | Veio 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}
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
| Tecla | O que faz |
|---|---|
| Tab | Navega para o elemento interativo seguinte |
| Shift+Tab | Navega para o elemento interativo anterior |
| Setas | Movem o foco entre os itens quando a lista é de seleção |
| Home e End | Vão ao primeiro e ao último item quando a lista é de seleção |
| Enter | Ativa o link ou a ação quando aplicável |
| Espaço | Ativa o Button ou alterna a seleção quando aplicável |
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
- DS gov.br V4 · next-ds — List, acessibilidade
- DS gov.br V3 · @govbr-ds/core — List (documentação e código de exemplo)
- W3C HTML-AAM · HTML-AAM — ul, ol, li
- eMAG 3.1 · eMAG 3.1 — Recomendação 1.2 (organizar o código HTML de forma lógica e semântica)
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.