Accessibility in Angular ListView component

12 Sep 20254 minutes to read

The ListView component adheres to 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 ListView component is outlined below.

Accessibility Criteria Compatibility
WCAG 2.2 Support Intermediate
Section 508 Support Intermediate
Screen Reader Support Yes
Right-To-Left Support Yes
Color Contrast Yes
Mobile Device Support Yes
Keyboard Navigation Support Yes
Accessibility Checker Validation Intermediate
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 ListView component follows the WAI-ARIA patterns to meet accessibility requirements. The following ARIA attributes are used in the ListView component based on different configurations:

Attributes Purpose
role=list Specifies the non selectable list container.
role=listitem Specifies the role of each item in a selectable ListView and its containment within the list.
role=presentation Specifies the role of non selectable list element.
role=checkbox Indicates checkbox component along with listitem element.
aria-checked Indicates the current checked state of checkbox.
aria-label Provides an accessible name for the ListView Checkbox.
aria-disabled Indicates element is perceivable but disabled.

Keyboard interaction

The ListView component follows the keyboard interaction guidelines, making it accessible for users who rely on assistive technologies (AT) and keyboard navigation. The following keyboard shortcuts are supported by the ListView component:

Keyboard shortcuts Actions
Arrow Up Moves focus to the previous list item
Arrow Down Moves focus to the next list item
Space Checks and unchecks the targeted list item when showCheckBox is enabled
BackSpace Navigates back to the previous list level in nested list scenarios
Home Moves focus to the first list item
End Moves focus to the last list item

Ensuring accessibility

The ListView component’s accessibility levels are validated through accessibility-checker and axe-core software tools during automated testing.

The accessibility compliance of the ListView component is demonstrated in the following sample. Open the sample in a new window to evaluate the accessibility of the ListView component with accessibility tools.

See also