Pular para o conteúdo principal

Menu

A confirmar

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 DSV3 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 / componentebr-menu
OrigemVeio 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}

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 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​

TeclaO que faz
TabMove o foco para dentro ou fora do Side Menu
Setas ↑/↓Navegam verticalmente entre itens
Setas ←/→Expandem/recolhem subitens (se aplicável)
EnterAtiva o item selecionado ou abre/fecha submenu
EspaçoAtiva o item ou alterna estado de expansão
EscFecha submenu em foco ou retorna ao item pai
Fonte: documentação do DS gov.br (V4).

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​

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.