Message
| Versões do DS | V3 e V4 |
| Papel (role) | alert (V3, mensagem que aparece) · status ou alert conforme urgência (V4) |
| Elemento HTML | <div role="alert"> ou <div role="status"> com texto |
| Classe / componente | br-message |
| Origem | Veio da documentação do DS gov.br, completada onde faltava. |
Documentação oficial: gov.br/ds · next-ds.
Nome acessível
O tipo e o texto da mensagem ("Erro: …", "Sucesso: …"). O ícone é decorativo (aria-hidden) e o tipo não pode ficar só na cor. Exemplo: Sucesso: dados salvos.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome} (anunciado ao aparecer, sem mover o foco)
Estados
Erro / aviso importante
- No código:
role="alert" (aria-live="assertive") - Acrescenta ao anúncio: {nome}
Informação / sucesso
- No código:
role="status" (aria-live="polite") - Acrescenta ao anúncio: {nome}
Com botão de fechar
- No código:
botão com aria-label "Fechar a mensagem" - Acrescenta ao anúncio: botão, fechar a mensagem
Teclado
| Tecla | O que faz |
|---|---|
| Tab | Move o foco para o próximo elemento na mensagem |
| Shift+Tab | Retorna ao elemento anterior |
| Enter/Espaço | Ativa botões de ação, como “Fechar” ou “Confirmar” |
Para o desenvolvimento
br-message (V3) / <br-message> (V4). A região viva precisa existir antes de receber o texto, senão alguns leitores não anunciam. Mensagem ligada a um campo: aria-describedby no campo. Botão de fechar com nome ("Fechar a mensagem").
Diferenças entre V3 e V4
- V3: notaCodigo: br-message: o exemplo do core usa role="alert" no conteúdo e aria-label no tipo ("Sucesso.", "Informação.").
- V4: notaCodigo: <br-message>: usar aria-live="polite" ou "assertive" conforme a urgência.
Fontes
- DS gov.br V4 · next-ds — Message, acessibilidade
- DS gov.br V3 · @govbr-ds/core — Message (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Alert Pattern
- WCAG · WCAG 2.2 — 4.1.3 Mensagens de status
- eMAG 3.1 · eMAG 3.1 — Recomendação 6.6 (identificar e descrever erros de entrada de dados e confirmar o envio)
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.