← Todas as regras

ARIA

Dicas de tela precisam de conteúdo

• Regra: aria-tooltip-name
• Gravidade: Grave
• Nível WCAG A

Por que isso importa

Um elemento com role="tooltip" e sem texto não produz nada quando o controle que ele descreve recebe o foco: a explicação extra se perde.

Como corrigir

1. Coloque o texto explicativo dentro do elemento da dica.
2. Referencie-o a partir do controle com aria-describedby.
3. Nunca deixe uma informação apenas na dica de tela — em dispositivos de toque elas são pouco confiáveis.

Na marcação

<div role="tooltip" id="tip"></div>

<div role="tooltip" id="tip">Opens in a new window</div>

A exigência por trás disso

Esta regra é uma das formas de falhar nos seguintes critérios de sucesso das WCAG 2.2. O W3C, que publica a norma, explica cada um deles:

• 4.1.2 Nome, função e valor (abre em nova aba) — Nível WCAG A

Para aprofundar

Deque University sobre aria-tooltip-name (abre em nova aba)

A Deque mantém o axe-core, o motor de código aberto que o nosso scanner executa. A página deles documenta a regra como o motor a implementa.

Verificações automáticas encontram falhas que o navegador consegue comprovar. Elas não julgam se uma legenda está correta, se um texto alternativo é útil, nem se a página pode ser operada de ponta a ponta pelo teclado — isso exige uma pessoa.