Accessibility in EJ2 TypeScript List box control

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 Yes
Section 508 Support Yes
Screen Reader Support Yes
Right-To-Left Support Yes
Color Contrast Yes
Mobile Device Support Yes
Keyboard Navigation Support Yes
Accessibility Checker Validation Yes
Axe-core Accessibility Validation Yes
Yes - All features of the component meet the requirement.
Intermediate - Some features of the component do not meet the requirement.
No - 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.

See also