Uma descrição ligada ao controle
Um tooltip é uma pequena área de texto que aparece quando um elemento recebe foco de teclado ou fica sob o ponteiro. Ele apresenta informação complementar sobre aquele elemento sem deslocar o foco para a dica. O controle continua disponível para a ação que você pretendia executar.
O guia de práticas ARIA (Accessible Rich Internet Applications), chamado APG (ARIA Authoring Practices Guide), descreve a relação por aria-describedby. Esse atributo fica no elemento de origem e aponta para o identificador do texto com role="tooltip". Assim, a descrição fica associada ao controle também para as tecnologias assistivas.
O botão e a descrição adicional
Neste exemplo didático, um botão tem o nome acessível “Copiar link” e uma dica com o texto “Copia o endereço desta página”. Você identifica a ação pelo nome do botão e consulta a descrição para saber qual endereço será copiado.
Ao navegar até o botão com Tab, você deve conseguir ler a dica sem mover o foco para ela. O mesmo texto aparece ao manter o ponteiro sobre o botão. Escape fecha a dica e preserva o foco no botão, conforme o padrão do APG.
Uma dica aberta pelo ponteiro deve continuar visível quando você move o ponteiro do controle para o próprio tooltip. Fechá-la nesse percurso pode impedir a leitura do texto. A permanência precisa permitir que você leia e dispense o conteúdo sem perder a posição na página.
Limites do padrão de tooltip
Um link dentro da dica precisaria receber foco para ser acionado pelo teclado. Como o tooltip não recebe foco, esse conteúdo exige outro padrão, como um diálogo não modal, com o tratamento de interação correspondente. Uma instrução necessária para preencher um campo pode ficar visível junto dele para ser consultada durante o preenchimento.
O APG informa que a proposta de tooltip ainda está em desenvolvimento e não tem consenso do grupo. Use essa ressalva ao consultar o padrão e teste a implementação com teclado e tecnologias assistivas. A aparência da dica não confirma que sua descrição está associada ao controle.
Dúvidas frequentes
Perguntas frequentes sobre tooltip
- Um tooltip pode conter links ou botões?
- O padrão de tooltip do APG mantém o foco no elemento de origem. Um painel com controles que recebem foco exige outro padrão de interação, como um diálogo não modal.
- Como fechar a dica sem mover o foco?
- O padrão do APG usa Escape para dispensar o tooltip. Depois disso, o foco permanece no controle que apresentou a dica.
- O tooltip pode ser a única identificação de um botão?
- O botão precisa ter um nome acessível que identifique sua ação. O tooltip pode acrescentar uma descrição, mas o nome precisa existir mesmo quando a dica está oculta.
Para continuar
Recursos relacionados
Documentação
W3C APG: padrão de tooltip
Padrão do guia de práticas ARIA para relacionar a dica ao controle e tratar foco e fechamento. A proposta ainda não tem consenso do grupo.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Sessão prática para você revisar uma dica de interface e testar a navegação por teclado com orientação técnica.
Abrir recursoDocumentação
W3C: conteúdo exibido por ponteiro ou foco
Orientações sobre fechamento, permanência e passagem do ponteiro para o conteúdo adicional.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A revisão de uma dica de interface inclui sua descrição acessível e a navegação pelo teclado.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.