Accessibility Checklists

Accessible Combobox Checklist (WCAG)

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

UI rules

RuleLevelRequirementWCAG 2.2Basis
combobox/visible-focusMustThe field shows a focus ring while its text has focus, and the highlighted option an outline at least 2px thick2.4.7 Focus Visible (AA)WCAG 2.4.7 (AA)
combobox/selected-not-colourMustA picked option shows a check mark as well as its weight, and its tag, with multiple1.4.1 Use of Color (A)WCAG 1.4.1 (A)
combobox/contrastMustThe text, the placeholder and "No results" have 4.5:1, and the border, the chevron and the focus ring 3:1, in light and dark mode1.4.3 Contrast (Minimum) (AA), 1.4.11 Non-text Contrast (AA)WCAG 1.4.3, 1.4.11 (AA)
combobox/target-sizeMustThe toggle and each remove button are at least 24 × 24px to press, and 44px tall where a pointer is coarse, like the options2.5.8 Target Size (Minimum) (AA)Open Components, beyond WCAG 2.5.8 (AA)
combobox/reflowMustThe field and the panel fit a 320px-wide screen without scrolling sideways, and long labels wrap1.4.10 Reflow (AA)WCAG 1.4.10 (AA)
combobox/reduced-motionShouldThe chevron and the panel don't animate when people ask for less motion2.3.3 Animation from Interactions (AAA)WCAG 2.3.3 (AAA)

UX rules

RuleLevelRequirementWCAG 2.2Basis
combobox/editable-patternMustThe text field has the combobox role, aria-autocomplete="list", aria-expanded and aria-controls, which points at a listboxNoneAPG
combobox/focus-in-textMustFocus stays in the text field, and aria-activedescendant points at the highlighted option while the panel is openNoneAPG
combobox/nameMustIt has a visible label, from a Field or a <label for>1.3.1 Info and Relationships (A), 3.3.2 Labels or Instructions (A)WCAG 1.3.1, 3.3.2 (A)
combobox/keyboardMustEvery key in the contract does what it says, and nothing needs a pointer2.1.1 Keyboard (A)WCAG 2.1.1 (A)
combobox/typing-editsMustLetters, Space, Home, End and the side arrows edit the text, and never move the highlightNoneAPG
combobox/escapeMustEscape closes the panel, then clears the text, and goes no further, so a Dialog around it stays openNoneAPG
combobox/no-resultsMustWith no match, the panel says so, in text that isn't an option, and screen readers hear it4.1.3 Status Messages (AA)WCAG 4.1.3 (AA)
combobox/result-countShouldThe number of matches is announced once typing pauses, never on every key4.1.3 Status Messages (AA)WCAG 4.1.3 (AA)
combobox/removable-tagsMustWith multiple, each tag has a named button that removes it, focus moves on to the next one, and Backspace in empty text removes the last2.1.1 Keyboard (A), 4.1.2 Name, Role, Value (A)WCAG 2.1.1, 4.1.2 (A)
combobox/announce-removalShouldRemoving a value is announced4.1.3 Status Messages (AA)WCAG 4.1.3 (AA)
combobox/autocompleteShouldautocomplete names the field's purpose where it asks people about themselves, and stays off elsewhere1.3.5 Identify Input Purpose (AA)WCAG 1.3.5 (AA)

DX rules

RuleLevelRequirementWCAG 2.2Basis
combobox/in-a-fieldMustIn a Field, it takes the label, description, invalid and disabled state1.3.1 Info and Relationships (A)WCAG 1.3.1 (A)

AX rules

RuleLevelRequirementWCAG 2.2Basis
combobox/role-and-nameMustIt can be found with getByRole("combobox", { name }), and its options with getByRole("option", { name })4.1.2 Name, Role, Value (A)WCAG 4.1.2 (A)

Sources

Copyright © 2026