Item
| Versões do DS | V3 |
| Papel (role) | listitem (dentro de br-list) · link ou button quando interativo |
| Elemento HTML | <li>, <a> ou <button> |
| Classe / componente | br-item |
| Origem | A 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}
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
| Tecla | O que faz |
|---|---|
| Enter | Ativa o controle em foco |
| Espaço | Ativa botões e alterna controles |
| Tab / Shift+Tab | Move o foco para o controle seguinte / anterior |
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
- DS gov.br V3 · @govbr-ds/core — Item (documentação e código de exemplo)
- W3C HTML-AAM · HTML-AAM — li, a, button
- WCAG · WCAG 2.2 — 4.1.2 Nome, função, valor
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.