Skip to content

Find what you need, instantly

Search components, ARIA roles & attributes, and WCAG criteria.

All roles

listbox

Composite widget role

A widget presenting a list of options from which the user can select one or, with aria-multiselectable, several. Selection is tracked with aria-selected on each option, and it's navigated with the arrow keys. It underlies select-style and combobox popups; prefer a native `<select>` for simple cases.

Used on
A container presenting a list of selectable options.
Required properties
  • aria-multiselectableif more than one option may be selected
Accessible name
Required, via aria-labelledby or aria-label.
Example
role="listbox"
<ul role="listbox" aria-label="Colors">
  <li role="option" aria-selected="true">Red</li>
</ul>
See a live, tested example on the Listbox (single & multi-select) page