Header
| Versões do DS | V3 e V4 |
| Papel (role) | banner |
| Elemento HTML | <header> (filho direto do body) |
| Classe / componente | br-header |
| Origem | Veio 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}
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
| Tecla | O que faz |
|---|---|
| Tab | Move o foco entre os elementos interativos do Header |
| Shift+Tab | Retorna o foco para o elemento interativo anterior |
| Enter | Ativa o item em foco (links, botões e acionadores) |
| Espaço | Ativa botões no Header quando aplicável |
| Esc | Fecha menu, painel de busca ou camadas temporárias abertas |
| Setas | Navega horizontalmente em grupos de navegação, quando houver |
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
- DS gov.br V4 · next-ds — Header, acessibilidade
- DS gov.br V3 · @govbr-ds/core — Header (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Landmark Regions
- eMAG 3.1 · eMAG 3.1 — Recomendação 1.5 (fornecer âncoras para ir direto a um bloco de conteúdo)
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.