Pular para o conteúdo principal

Tooltip

Versões do DSV3 e V4
Papel (role)tooltip (conteúdo) ligado ao gatilho por aria-describedby
Elemento HTML<div role="tooltip"> + gatilho focável com aria-describedby
Classe / componentebr-tooltip
OrigemVeio da documentação do DS gov.br, completada onde faltava.

Documentação oficial: gov.br/ds · next-ds.

Nome acessível​

O tooltip não dá nome ao gatilho: ele só complementa. O gatilho precisa ter nome próprio; o tooltip entra como descrição. Exemplo: Gatilho: Ajuda · descrição: Informe o CPF sem pontos.

O que é anunciado​

Esperado conforme o padrão (WAI-ARIA APG): {nome}, {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​

Visível​

  • No código: role="tooltip"; gatilho com aria-describedby="id-do-tooltip"
  • Acrescenta ao anúncio: {nome}, {descricao}

Teclado​

TeclaO que faz
TabMove o foco para o elemento que aciona o Tooltip
Shift+TabRetorna ao elemento anterior
EscFecha o Tooltip quando estiver visível
Enter/EspaçoAtiva o elemento associado, caso o elemento gatilho seja interativo
Fonte: documentação do DS gov.br (V4).

Para o desenvolvimento​

br-tooltip (V3) / <br-tooltip> (V4). Aparece no foco e no passar do mouse; Esc fecha; o ponteiro pode entrar no tooltip sem ele sumir (WCAG 1.4.13). Não coloque conteúdo essencial nem interativo no tooltip. No core 3.x a documentação marca o tooltip como obsoleto e o v3-site diz para usá-lo só quando indispensável e oferecer alternativa.

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.