How can I help you?
Accessibility in React ListBox component
21 Feb 20264 minutes to read
The ListBox component adheres to established accessibility guidelines and standards, including ADA, Section 508, WCAG 2.2 standards, and WCAG roles.
The accessibility compliance for the ListBox component is outlined below.
| Accessibility Criteria | Compatibility |
|---|---|
| WCAG 2.2 Support |  |
| Section 508 Support | |
| Screen Reader Support | |
| Right-To-Left Support | |
| Color Contrast | |
| Mobile Device Support | |
| Keyboard Navigation Support | |
| Accessibility Checker Validation | |
| Axe-core Accessibility Validation | |
- All features of the component meet the requirement.
- Some features of the component do not meet the requirement.
- The component does not meet the requirement.WAI-ARIA attributes
The ListBox component implements WAI-ARIA patterns to ensure accessibility compliance. The following ARIA attributes are used in the ListBox component:
| Attributes | Purpose |
|---|---|
role |
Indicates the ListBox component wrapper element as listbox, the UL element as presentation, and its list item as option. |
aria-label |
Provides an accessible name for the ListBox component. |
aria-multiselectable |
Applied to the element with the ListBox role, tells assistive technologies that the list supports multiple selection. The default value is true. |
aria-selected |
Applied to elements with role option that are visually styled as selected to inform assistive technologies that the options are selected. |
Keyboard interaction
The ListBox component follows keyboard interaction guidelines, enabling seamless navigation for users with assistive technologies and keyboard-only users. The following keyboard shortcuts are supported:
| Press | To do this |
|---|---|
| Up arrow | Moves focus to the previous option. |
| Down arrow | Moves focus to the next option. |
| Home | Moves focus to first option. |
| End | Moves focus to last option. |
| Space | Changes the selection state of the focused option. |
| Ctrl + A | Selects all options in the list. |
| Ctrl + Shift + Home | Selects the focused option and all options up to the first option. |
| Ctrl + Shift + End | Selects the focused option and all options down to the last option. |
| Ctrl + (Up or Down) | Press Ctrl key with up / down arrow or mouse to select multiple items. |
Ensuring accessibility
The ListBox component’s accessibility levels are ensured through an accessibility-checker and axe-core software tools during automated testing.
The accessibility compliance of the ListBox component is shown in the following sample. Open the sample in a new window to evaluate the accessibility of the ListBox component with accessibility tools.