Pular para o conteúdo principal

Message

Versões do DSV3 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 / componentebr-message
OrigemVeio 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)

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​

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​

TeclaO que faz
TabMove o foco para o próximo elemento na mensagem
Shift+TabRetorna ao elemento anterior
Enter/EspaçoAtiva botões de ação, como “Fechar” ou “Confirmar”
Fonte: documentação do DS gov.br (V4).

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​

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.