spec checked
WAI-ARIA APG Combobox Pattern
Defines combobox as an input widget with an associated popup, editable and select-only variants, collapsed and expanded states, popup roles, aria-controls, aria-expanded, aria-activedescendant, option selection, Escape cancellation, Enter acceptance, and keyboard behavior while preserving standard text editing.
Pattern Decisions This Source Supports
| Pattern | Supported decision | Required contract | Claim note |
|---|---|---|---|
| Combobox | Choose a combobox when a single field controls a popup of allowed or suggested values. | The combobox element owns or controls its popup with aria-controls when the popup is available. | APG defines the combobox widget, popup ownership, aria-expanded, aria-controls, active descendant, Enter acceptance, Escape cancellation, and differences from listbox and menu button patterns. |
| Object picker | Choose object picker when users must select an existing record, person, group, file, account, project, team, workspace, or other entity with a stable ID. | Typing searches or filters permitted objects without committing the first visible result. | APG combobox guidance supports the accessible popup, expanded state, active descendant, Enter acceptance, Escape cancellation, and selected value mechanics an object picker commonly builds on. |
Evidence Role
This source is treated as spec evidence. Use it to validate the decision rules above, not as a visual style reference.
Publisher: W3C Web Accessibility Initiative. Last checked: .