Accessibility Checklists

Accessible Tooltip Checklist (WCAG)

Every Tooltip rule that WCAG 2.2, WAI-ARIA or the APG backs, in one checklist, with the success criteria behind each rule and their level.

Here's every rule for the Tooltip that WCAG 2.2, WAI-ARIA or the APG backs, in one list you can work through when you build or review one. Each row names the WCAG 2.2 success criteria behind its rule, with their level, and links to the rule's table on its layer's page, where we explain why it's there. A rule that rests on WAI-ARIA or the APG alone says "None".

We build this list from the Tooltip's checklists, so it always matches them. It leaves out the rules that rest only on HTML and the ones that are our own, so you'll find every rule in the Tooltip's checklist.

UI rules

RuleLevelRequirementWCAG 2.2Basis
tooltip/contrastMustIts text has a contrast of 4.5:1 against its fill1.4.3 Contrast (Minimum) (AA)WCAG 1.4.3 (AA)
tooltip/wrapsShouldLong text wraps at a maximum width set in ch, and is never cut off or scrolled1.4.4 Resize Text (AA), 1.4.10 Reflow (AA)WCAG 1.4.4, 1.4.10 (AA)
tooltip/reduced-motionMustWith prefers-reduced-motion: reduce, it fades in without growing or moving2.3.3 Animation from Interactions (AAA)WCAG 2.3.3 (AAA), Open Components

UX rules

RuleLevelRequirementWCAG 2.2Basis
tooltip/focus-opensMustKeyboard focus on its trigger opens it at once2.1.1 Keyboard (A)WCAG 2.1.1 (A)
tooltip/hoverableMustThe pointer can cross from the trigger onto the tooltip, within a short grace period, without closing it1.4.13 Content on Hover or Focus (AA)WCAG 1.4.13 (AA)
tooltip/persistentMustIt stays open while its trigger has hover or focus, and never hides on a timer1.4.13 Content on Hover or Focus (AA)WCAG 1.4.13 (AA)
tooltip/dismiss-with-escapeMustEscape dismisses it without moving focus or the pointer1.4.13 Content on Hover or Focus (AA)WCAG 1.4.13 (AA)
tooltip/focusable-triggerMustIts trigger is focusable, and a disabled one uses aria-disabled rather than disabled2.1.1 Keyboard (A)Open Components, beyond WCAG 2.1.1 (A)

AX rules

RuleLevelRequirementWCAG 2.2Basis
tooltip/describesMustWith type="description", it's role="tooltip", and its trigger points to its id with aria-describedbyNoneWAI-ARIA
tooltip/shows-labelMustWith type="label", it's aria-hidden, nothing points to it, and the trigger keeps its own name4.1.2 Name, Role, Value (A)WCAG 4.1.2 (A), Open Components
tooltip/named-triggerMustIts trigger has an accessible name of its own, like an icon-only Button's hidden label4.1.2 Name, Role, Value (A)WCAG 4.1.2 (A)
tooltip/in-the-domMustIt stays in the DOM while it's closed, so its trigger's description is always thereNoneWAI-ARIA

Sources

Copyright © 2026