Tooltip
| Versões do DS | V3 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 / componente | br-tooltip |
| Origem | Veio 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}
Estados
Visível
- No código:
role="tooltip"; gatilho com aria-describedby="id-do-tooltip" - Acrescenta ao anúncio: {nome}, {descricao}
Teclado
| Tecla | O que faz |
|---|---|
| Tab | Move o foco para o elemento que aciona o Tooltip |
| Shift+Tab | Retorna ao elemento anterior |
| Esc | Fecha o Tooltip quando estiver visível |
| Enter/Espaço | Ativa o elemento associado, caso o elemento gatilho seja interativo |
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
- DS gov.br V4 · next-ds — Tooltip, acessibilidade
- DS gov.br V3 · @govbr-ds/core — Tooltip (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Tooltip Pattern
- WCAG · WCAG 2.2 — 1.4.13 Conteúdo em foco ou ao passar o mouse
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.