Accessibility Checklists

Accessible Spinner Checklist (WCAG)

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

UI rules

RuleLevelRequirementWCAG 2.2Basis
spinner/contrastMustThe indicator has a contrast of 3:1 against what's behind it1.4.11 Non-text Contrast (AA)WCAG 1.4.11 (AA)
spinner/reduced-motionMustIt doesn't turn when prefers-reduced-motion: reduce is set, but still shows that something's happening, like with a pulse2.3.3 Animation from Interactions (AAA)WCAG 2.3.3 (AAA), Open Components

UX rules

RuleLevelRequirementWCAG 2.2Basis
spinner/decorativeMustIt's hidden from assistive technologies with aria-hidden, and has no role or name of its own1.1.1 Non-text Content (A)WCAG 1.1.1 (A)
spinner/say-what-loadsMustWhatever shows it says what's loading, in a status message that's already in the page or with a label it announces, like the Button's loadingLabel4.1.3 Status Messages (AA)WCAG 4.1.3 (AA)
spinner/announce-outcomeShouldWhen the wait ends, the page says how it went, in the same status message, or in an alert for an error that needs attention straight away4.1.3 Status Messages (AA)Open Components, beyond WCAG 4.1.3 (AA)
spinner/remove-when-doneMustIt's taken out as soon as the wait ends or fails, so it never turns with nothing to wait for2.2.2 Pause, Stop, Hide (A)Open Components, beyond WCAG 2.2.2 (A)

Sources

Copyright © 2026