Pular para o conteúdo principal

Notification

A confirmar

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 DSV3
Papel (role)região de painel com abas (Alertas, Mensagens); itens como link ou button
Elemento HTML<div> com abas (<button>) e <ul>
Classe / componentebr-notification
OrigemA 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}

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​

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​

TeclaO que faz
EnterAtiva o controle em foco
EspaçoAtiva botões e alterna controles
Tab / Shift+TabMove o foco para o controle seguinte / anterior
Fonte: curadoria (WAI-ARIA APG).

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​

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.