Accessibility Checklists

Accessible Switch Checklist (WCAG)

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

UI rules

RuleLevelRequirementWCAG 2.2Basis
switch/contrastMustThe track and the thumb have a contrast of 3:1 against what's next to them, on and off, and so does the focus ring1.4.11 Non-text Contrast (AA)WCAG 1.4.11 (AA)
switch/more-than-colourMustOn and off differ by more than colour: the thumb moves to the other end, and the track fills1.4.1 Use of Color (A)WCAG 1.4.1 (A)
switch/focus-visibleMustFocus shows an outline at least 2px thick around the track, outside it2.4.7 Focus Visible (AA), 2.4.13 Focus Appearance (AAA)WCAG 2.4.7 (AA), 2.4.13 (AAA)
switch/target-sizeMustThe hit area is at least 24 × 24px, and at least 44 × 44px on touch screens2.5.8 Target Size (Minimum) (AA), 2.5.5 Target Size (Enhanced) (AAA)WCAG 2.5.8 (AA), 2.5.5 (AAA)
switch/resizableMustThe track and the thumb are sized in rem, so they grow with the text1.4.4 Resize Text (AA)Open Components, beyond WCAG 1.4.4 (AA)
switch/reduced-motionMustThe thumb doesn't slide when prefers-reduced-motion: reduce is set2.3.3 Animation from Interactions (AAA)WCAG 2.3.3 (AAA)

UX rules

RuleLevelRequirementWCAG 2.2Basis
switch/native-elementMustIt's a native <input type="checkbox"> with role="switch", and never a <div>2.1.1 Keyboard (A), 4.1.2 Name, Role, Value (A)APG, Open Components, beyond WCAG 2.1.1, 4.1.2 (A)
switch/checked-stateMustIts state is the checkbox's own checked, announced as on or off, with no pressed or mixed stateNoneWAI-ARIA, APG
switch/visible-labelMustEvery switch has a visible <label>, linked with for1.3.1 Info and Relationships (A), 3.3.2 Labels or Instructions (A), 4.1.2 Name, Role, Value (A)WCAG 1.3.1, 3.3.2, 4.1.2 (A)
switch/label-in-nameMustAn aria-label or aria-labelledby includes the visible label, ideally at the start2.5.3 Label in Name (A)WCAG 2.5.3 (A)
switch/stable-labelMustThe label names the setting and stays the same whether the switch is on or offNoneAPG
switch/describedShouldHints, like what the setting changes, are linked with aria-describedby1.3.1 Info and Relationships (A)WCAG 1.3.1 (A)
switch/keyboardMustTab reaches the switch, and Space and a click on its label flip it2.1.1 Keyboard (A)WCAG 2.1.1 (A), APG
switch/announce-savedShouldWhile its change is saved, it keeps its new state and stays enabled, and a status message says when it's saved4.1.3 Status Messages (AA)WCAG 4.1.3 (AA), Open Components
switch/no-context-changeMustFlipping it never moves focus, opens a page or submits a form, unless its hint says so first3.2.2 On Input (A)WCAG 3.2.2 (A)
switch/error-messageMustAn invalid switch has an error message, in text and linked with aria-describedby, that says what happened and what to do1.4.1 Use of Color (A), 3.3.1 Error Identification (A)WCAG 1.4.1, 3.3.1 (A)
switch/invalid-stateMustA switch sets aria-invalid="true" while its error message shows, and only looks invalid when it does4.1.2 Name, Role, Value (A)WCAG 4.1.2 (A), Open Components
switch/read-onlyMustA read-only switch can be focused and is sent with its form, but doesn't flip, and sets aria-readonly="true"NoneWAI-ARIA

AX rules

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

Sources

Copyright © 2026