Menu
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 DS | V3 e V4 |
| Papel (role) | navigation (links e botões de expandir); V4 documenta menu/menuitem ou tree/treeitem |
| Elemento HTML | <nav aria-label="Menu principal"> com <ul>, <a> e <button aria-expanded> |
| Classe / componente | br-menu |
| Origem | Veio da documentação do DS gov.br, completada onde faltava. |
Documentação oficial: gov.br/ds · next-ds.
Nome acessível
A navegação leva nome ("Menu principal"); cada item é o texto do link; o botão de submenu leva o nome do grupo. Exemplo: Menu principal.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}, navegação · {nome}, link{estado}
Estados
Expandido / recolhido
- No código:
aria-expanded="true|false" no botão do item com subitens - Acrescenta ao anúncio: expandido / recolhido
Item da página atual
- No código:
aria-current="page" - Acrescenta ao anúncio: página atual
Desabilitado
- No código:
aria-disabled="true" - Acrescenta ao anúncio: indisponível
Teclado
| Tecla | O que faz |
|---|---|
| Tab | Move o foco para dentro ou fora do Side Menu |
| Setas ↑/↓ | Navegam verticalmente entre itens |
| Setas ←/→ | Expandem/recolhem subitens (se aplicável) |
| Enter | Ativa o item selecionado ou abre/fecha submenu |
| Espaço | Ativa o item ou alterna estado de expansão |
| Esc | Fecha submenu em foco ou retorna ao item pai |
Para o desenvolvimento
br-menu (V3) / <br-side-menu> (V4, id "side-menu" na base). No exemplo V3: aria-label="Menu principal", aria-expanded nos itens com submenu, ícones aria-hidden. A base V4 cita menu/menuitem ou tree/treeitem; o APG reserva role="menu" para menus de aplicativo e orienta navegação de site com botões de divulgação (disclosure). A confirmar com o time de desenvolvimento qual padrão será implementado.
Diferenças entre V3 e V4
- V4: papel: navigation, com menu/menuitem ou tree/treeitem nos itens conforme a base V4
Fontes
- DS gov.br V4 · next-ds — Side Menu, acessibilidade
- DS gov.br V3 · @govbr-ds/core — Menu (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Example Disclosure Navigation Menu
- W3C WAI-ARIA APG · WAI-ARIA APG — Tree View Pattern
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.