Notification
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 |
| Papel (role) | região de painel com abas (Alertas, Mensagens); itens como link ou button |
| Elemento HTML | <div> com abas (<button>) e <ul> |
| Classe / componente | br-notification |
| 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
Abas e painel levam nome ("Alertas", "Mensagens"); cada item, o texto da notificação; botão fechar com aria-label. Exemplo: Alertas.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}, guia, {posicao} de {total}{estado}
Estados
Notificação nova
- No código:
região viva aria-live="polite" para o contador/aviso - Acrescenta ao anúncio: nova notificação
Aba selecionada
- No código:
aria-selected="true" - Acrescenta ao anúncio: selecionada
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-notification (V3). No exemplo do core as abas levam aria-label "Alertas"/"Mensagens" e os itens usam role="contentinfo" com aria-label para a mensagem lida pelo leitor. A confirmar: contentinfo é marco de rodapé, não papel de item; prefira itens como link/button dentro de lista e uma região viva para a chegada de novas notificações.
Fontes
- DS gov.br V3 · @govbr-ds/core — Notification (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Landmark Regions
- WCAG · WCAG 2.2 — 4.1.3 Mensagens de status
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.