Pular para o conteúdo principal

Header

Versões do DSV3 e V4
Papel (role)banner
Elemento HTML<header> (filho direto do body)
Classe / componentebr-header
OrigemVeio da documentação do DS gov.br, completada onde faltava.

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

Nome acessível​

O banner dispensa nome; a navegação principal e a busca levam nomes ("Menu principal", "Pesquisar"); botões de ícone levam aria-label. Exemplo: Menu principal.

O que é anunciado​

Esperado conforme o padrão (WAI-ARIA APG): banner · {nome}, navegação · {nome}, botão{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 que abre o menu ou a busca
  • Acrescenta ao anúncio: expandido / recolhido

Busca aberta​

  • No código: role="search" no contêiner do campo
  • Acrescenta ao anúncio: pesquisa

Teclado​

TeclaO que faz
TabMove o foco entre os elementos interativos do Header
Shift+TabRetorna o foco para o elemento interativo anterior
EnterAtiva o item em foco (links, botões e acionadores)
EspaçoAtiva botões no Header quando aplicável
EscFecha menu, painel de busca ou camadas temporárias abertas
SetasNavega horizontalmente em grupos de navegação, quando houver
Fonte: documentação do DS gov.br (V4).

Para o desenvolvimento​

br-header (V3) / <br-header> (V4). Um banner por página, fora de outros marcos. Botões "Menu", "Pesquisar", "Fechar" com aria-label (como no core); ícones aria-hidden. Esc fecha a busca/menu e devolve o foco ao botão que abriu.

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.