Tooltip
Dica de ferramenta
Uma tooltip é uma nota curta sobre um controle. Ela abre quando o mouse passa por cima ou o teclado foca no controle. As pessoas não podem usá-la como um botão.
role="tooltip"Um exemplo real
Quando um botão de ícone recebe foco do teclado, “Copiar link” aparece. O foco permanece no botão.
Partes principais
- 01Acionar
- 02Anchored or modal surface
- 03Focus boundary
- 04Dismiss path
Use-o quando
Use-o para explicar um rótulo de controle curto tanto ao passar o mouse quanto ao focar com o teclado.
Não o use quando
Nunca coloque ações, instruções obrigatórias ou conteúdo longo dentro de uma dica de ferramenta.
Nome usado no código
role="tooltip" Antes de lançar
Move focus on purpose. Keep it inside only when the overlay blocks the page. Support Escape and a visible close button, then return focus to the opener. Keep entered data and check small-screen, loading, and failure states.
Outcome: Complete the task with Dica de ferramenta (Tooltip). User context: Quando um botão de ícone recebe foco do teclado, “Copiar link” aparece. O foco permanece no botão. Recommended pattern: Dica de ferramenta (Tooltip). Why it fits: Use-o para explicar um rótulo de controle curto tanto ao passar o mouse quanto ao focar com o teclado. Do not use it when: Nunca coloque ações, instruções obrigatórias ou conteúdo longo dentro de uma dica de ferramenta. Product requirements: Define the default, loading, empty, error, success, and recovery states. Keep user input. Give clear feedback after every action. Accessibility and resilience: Use semantic HTML, full keyboard access, and visible focus. Make the layout work when zoomed and support reduced motion. Follow the project’s current rules. Do not add a new UI library unless the project already uses it. Acceptance criteria: The main task works with keyboard only and at 320px width. Focus and status changes are announced. Check loading, failure, retry, cancel, and reduced-motion paths. Evidence and limits (evidence boundary): O padrão cobre apenas o escopo listado. Ele não escolhe o estilo visual, decisão do produto ou exemplo de Vibulary. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Conferir este pedido
Review how Dica de ferramenta (Tooltip) is used now. Definition: Uma tooltip é uma nota curta sobre um controle. Ela abre quando o mouse passa por cima ou o teclado foca no controle. As pessoas não podem usá-la como um botão. Release checks: Move focus on purpose. Keep it inside only when the overlay blocks the page. Support Escape and a visible close button, then return focus to the opener. Keep entered data and check small-screen, loading, and failure states. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.