Accessibility in React ListBox component
24 Jan 20244 minutes to read
The ListBox component followed the accessibility guidelines and standards, including ADA, Section 508, WCAG 2.2 standards, and WCAG roles that are commonly used to evaluate accessibility.
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 followed the WAI-ARIA patterns to meet the accessibility. 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 followed the keyboard interaction guideline, making it easy for people who use assistive technologies (AT) and those who completely rely on keyboard navigation. The following keyboard shortcuts are supported by the ListBox component.
| 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.