Combobox Validator
Comboboxes must expose aria-expanded, aria-controls pointing at a valid popup, aria-autocomplete, and an accessible name.
Paste your HTML
Editorial guidance
How this widgets tool supports accessibility work
The combobox validator is designed to turn a common accessibility review task into a repeatable workflow. It focuses on aria 1.2 combobox pattern — aria-expanded, aria-controls, aria-autocomplete, listbox. The goal is not to replace expert judgment, but to make the first review faster, more consistent, and easier to explain to designers, developers, QA teams, and content owners.
Use the output as evidence for a remediation conversation. A failed check normally means the implementation needs a closer look against WCAG 4.1.2, while a passing check means the specific automated rule did not find a problem. Passing automated checks is helpful, but it is not the same as a full conformance claim.
For best results, test real production markup instead of simplified snippets. Templates, CSS state, JavaScript behavior, responsive layouts, and content changes can all affect the final accessibility experience. Re-run the tool after fixes so the before-and-after evidence is easy to compare.
Pair this tool with manual keyboard testing, zoom and reflow checks, screen-reader review, and content judgment. Those human checks catch issues that automated logic cannot reliably infer, such as whether labels are meaningful, instructions are clear, or a complete user task can be finished without a mouse.
How to use
- 1Paste the combobox HTML and any related popup markup such as listbox options.
- 2Check aria-expanded, aria-controls, naming, and whether the input or trigger follows the ARIA 1.2 pattern cleanly.
- 3Refine the relationships so assistive technology can understand when the popup opens and what it controls.
FAQs
Tips here are tailored for the combobox validator so people can move from checking to fixing faster.
What to verify manually
Keyboard: move through the related flow with Tab, Shift+Tab, Enter, Space, Escape, and arrow keys where the pattern expects them.
Assistive technology: check names, roles, states, reading order, announcements, and focus changes with at least one screen reader.
Content quality: confirm that instructions, labels, headings, errors, and alternatives make sense in the real user task.
This page is written as practical guidance, not a legal certification. For procurement, VPAT/ACR work, or regulated launches, combine tool output with expert review and documented manual test results.
Related learning