TreeView Accessibility
Out of the box, the Kendo React TreeView provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.
The TreeView is compliant with the Web Content Accessibility Guidelines (WCAG) 2.1 AA standards](https://www.w3.org/TR/WCAG21/) 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
The following table lists the selectors, attributes, and behavior patterns supported by the TreeView component:
| Selector | Attribute | Usage |
|---|---|---|
| .k-treeview | role=tree | The root div element of the treeview. |
| .k-treeview-group:not(.k-treeview-lines) | role=group | The ul element that wraps child nodes. |
| .k-treeview-item | role=treeitem | The li element rendered for a tree node. |
aria-level | Announces the level of the tree node item. The value of level is number-based(>=1). Should be added when only subsection of the TreeView is rendered in the DOM. | |
aria-setsize | Announces the total count of the items at this level. Helps the user understand the position of the navigation (ex: item 3 of 14). Should be added only when load more functionality of the tree is enabled and there are still nodes belonging to the group that are yet not loaded (rendered). | |
aria-expanded=true/false | Announces the expanded state of the node. It is true when expanded, and false when collapsed. | |
aria-checked=true/false | Rendered only when checkboxes are enabled and announces the checked state of the node. If the checkbox is indeterminate, the value is mixed. | |
| .k-selected | aria-selected=true | Rendered only when selection is enabled and announces the selected state of the node. |
| .k-checkbox | role=none/presentation | Added to the wrapper element of the checkbox to prevent duplicated information announced to the user. The checked state is controlled by aria-checked. |
aria-hidden=true | Added to the checkbox element to prevent duplicated information announced to the user. The checked state is controlled by aria-checked. |
If the tree supports Load More functionality, the load more button is rendered as li.k-treeview-item element and has role="button". The list item does not implement any of the above attributes.
Resources
ARIA practices File Directory Treeview Example
Section 508
The TreeView is fully compliant with the Section 508 requirements.
Testing
The TreeView has been extensively tested automatically with static code analyzers and manually with the most popular screen readers.
To report any accessibility issues, contact the team through the Telerik Support System.
Screen Readers
The following table lists the screen readers supported by the TreeView:
| Environment | Tool |
|---|---|
| Firefox | NVDA |
| Chrome | JAWS |
| Microsoft Edge | JAWS |
