ListView Accessibility
The ListView is accessible by screen readers and provides WAI-ARIA, Section 508, WCAG 2.2, and keyboard support.
For more information, refer to Accessibility in Kendo UI for jQuery.
Out of the box, the Kendo UI for jQuery ListView provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.
The ListView is compliant with the Web Content Accessibility Guidelines (WCAG) 2.2 AAA standards and Section 508 requirements, follows the Web Accessibility Initiative - Accessible Rich Internet Applications (WAI-ARIA) best practices for implementing the keyboard navigation for its component role, provides options for managing its focus and is tested against the most popular screen readers.
WAI-ARIA
This section lists the selectors, attributes, and behavior patterns supported by the component and its composite elements, if any.
| Selector | Attribute | Usage |
|---|---|---|
.k-listview:not(.k-selectable) .k-listview-content | role=list | Specifies the role of non selectable ListView content element. |
.k-listview.k-selectable .k-listview-content | role=listbox | Specifies the role of selectable ListView content element. |
.k-listview:not(.k-selectable) .k-listview-item | role=listitem | Specifies the role of each item in a non selectable ListView. |
.k-listview.k-selectable .k-listview-item | role=option | Specifies the role of each item in a selectable ListView. |
.k-listview-item | aria-setsize | Specifies the total number of items present in the ListView. |
aria-posinset | Specifies the position of the current item in the entire list of items present in the ListView. Value must be greated than or equal to 1 and smaller than or equal to the total number of items in the ListView. | |
.k-listview-item:nth-child(1) | tabindex=0 | The first item in the ListView must be focusable by default. |
Resources
WAI-ARIA Specification: Listitem
Section 508
The ListView is fully compliant with the Section 508 requirements.
Testing
The ListView has been extensively tested automatically with axe-core and manually with the most popular screen readers.
To report any accessibility issues, contact the team through the Telerik Support System.
Screen Readers
The ListView has been tested with the following screen readers and browsers combinations:
| Environment | Tool |
|---|---|
| Firefox | NVDA |
| Chrome | JAWS |
| Microsoft Edge | JAWS |
Automated Testing
The ListView has been tested with axe-core.
Test Example
A live test example of the ListView component could be found here: https://demos.telerik.com/kendo-ui/accessibility/listview