ARIA 1.2 Vocabulary

combobox

An input that controls another element, such as a listbox or grid, that can dynamically pop up to help the user set the value of the input.

Structure Data

Required Attributes

aria-* attributes that must be specified when using this role.

  • aria-controls
  • aria-expanded

Attributes with Implicit Defaults

These default values apply implicitly, even when not explicitly set.

AttributeDefault Value
aria-expandedfalse
aria-haspopuplistbox

Speech Notes

The virtual screen reader used in this site's demos and real screen readers (NVDA, VoiceOver, JAWS, etc.) don't always announce things the same way. This section lists known differences related to this role.

not expanded
NVDA / VoiceOver announce "collapsed" (same meaning, different wording).
expanded
Real screen readers also announce "expanded" (VoiceOver speaks it separately, period-delimited).
N control(s)
Real screen readers rarely announce this. NVDA / VoiceOver do not announce aria-controls, and JAWS has it off by default since 2019. Safe to ignore.

Reference