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.
What this source can teach
Use this source to check a technical or accessibility requirement against its exact wording and scope.
- Start with the original. Open the source and find the guidance or example relevant to your task.
- Trace the connection. Use the claim notes below to see how this site applies the source to specific patterns.
- Check the setting. Compare the source's platform, people, and constraints with your own decision.
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. |
Comparisons supported by this source
- Combobox vs autocomplete vs select vs text input
APG defines combobox popup ownership, editable and select-only behavior, expanded state, active descendant movement, Enter acceptance, Escape cancellation, and differences from listbox and menu button patterns.
Evidence Role
This source is treated as spec evidence. Its value comes from the specific claims and setting described above.
Publisher: W3C Web Accessibility Initiative. Last checked: .