Accessibility Checklists

Accessible Popover Checklist (WCAG)

Every Popover 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 Popover 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 Popover'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 Popover's checklist.

UI rules

RuleLevelRequirementWCAG 2.2Basis
popover/contrastMustThe title and the content have a contrast of 4.5:1 against the panel1.4.3 Contrast (Minimum) (AA)WCAG 1.4.3 (AA)
popover/fits-screenMustIt's never wider or taller than the screen less 16px on each side, down to 320px wide, and its body scrolls when its content doesn't fit1.4.10 Reflow (AA)WCAG 1.4.10 (AA)
popover/resizableMustIt's sized in rem, so it grows with its text, and its title wraps rather than getting cut off1.4.4 Resize Text (AA), 1.4.12 Text Spacing (AA)Open Components, beyond WCAG 1.4.4, 1.4.12 (AA)
popover/reduced-motionShouldIt only animates as it opens when prefers-reduced-motion is no-preference2.3.3 Animation from Interactions (AAA)WCAG 2.3.3 (AAA)

UX rules

RuleLevelRequirementWCAG 2.2Basis
popover/native-popoverMustIt's an element with popover="auto", which a popovertarget button opens before any script loads, and never a scripted overlay2.1.1 Keyboard (A)Open Components, beyond WCAG 2.1.1 (A)
popover/non-modalMustThe page around it keeps working: nothing is inert, nothing is aria-modal, and Tab can leave it2.1.2 No Keyboard Trap (A)WAI-ARIA, WCAG 2.1.2 (A)
popover/namedMustIt's role="dialog", named by its title with aria-labelledby4.1.2 Name, Role, Value (A)WCAG 4.1.2 (A)
popover/visible-titleMustEvery popover has a title that says what it holds, like "Filters"1.3.1 Info and Relationships (A), 2.4.6 Headings and Labels (AA)WCAG 1.3.1 (A), 2.4.6 (AA)
popover/triggerMustIts trigger is a button that points at it with popovertarget, and sets aria-haspopup="dialog"4.1.2 Name, Role, Value (A)WCAG 4.1.2 (A), HTML
popover/trigger-expandedMustIt keeps aria-expanded on its trigger in step with whether it's open, true only on the trigger that opened it4.1.2 Name, Role, Value (A)WCAG 4.1.2 (A)
popover/after-triggerShouldIt's rendered right after its trigger, so Tab and screen readers reach it next1.3.2 Meaningful Sequence (A), 2.4.3 Focus Order (A)WCAG 1.3.2, 2.4.3 (A)
popover/initial-focusMustOpening it moves focus inside, to the control marked with data-autofocus, or else the first in its body, then its close button2.4.3 Focus Order (A)WCAG 2.4.3 (A)
popover/return-focusMustClosing it while focus is inside moves focus back to its trigger, and a press outside leaves focus where people pressed2.4.3 Focus Order (A)WCAG 2.4.3 (A), HTML
popover/escapeMustEscape closes it, with focus in it, on its trigger or anywhere else on the page2.4.11 Focus Not Obscured (Minimum) (AA)HTML, WCAG 2.4.11 (AA)

AX rules

RuleLevelRequirementWCAG 2.2Basis
popover/role-and-nameMustIt can be found by its role and title alone, with getByRole("dialog", { name })4.1.2 Name, Role, Value (A)WCAG 4.1.2 (A)

Sources

Copyright © 2026