Accessibility Support
Out of the box, the Telerik and Kendo UI 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.2 standards and Section 508 requirements, follows the Web Accessibility Initiative - Accessible Rich Internet Applications (WAI-ARIA) best practices for implementing the keyboard navigation and provides options for managing its focus and is tested against the most popular screen readers.
Treeview
ARIA Attributes
| Attribute | Description |
|---|---|
role="tree" | The root list element of the treeview. |
role="group" | The ul element that wraps child nodes. |
Keyboard Navigation
| Trigger | Behavior |
|---|---|
Enter | Selects the focused tree view item when the selection mode is single or multiple. When the selection mode is multiple and there are other selected items, they get deselected. |
Space | Checks the checkbox of the TreeView node. |
ArrowUp | Goes to the previous tree node. The focus is moved to the previous node and its tabindex is set to 0. |
ArrowDown | Goes to the next tree node. The focus is moved to the next node and its tabindex is set to 0. |
ArrowLeft | If the node is expanded, collapses it and the focus remains on the item. If the node is collapsed, the focus is moved to its parent. |
ArrowRight | If the node is collapsed, expands it and the focus remains on the item. If the node is expanded, the focus is moved to the first child node. |
Home | Moves the focus to the first node in the tree without opening or closing a node. |
End | Moves the focus to the last node in the tree that is focusable without opening a node. |
Control/Cmd(Mac) + Enter | Selects the focused item. When the item is already selected, it gets deselected. |
Printable Characters | Typing M or any other printable character focuses the next or the first item in the list. |
UX Behavior
| Feature | Description |
|---|---|
| Expand / Collapse | Nodes with children can be expanded to reveal them. |
| Selection | A node is selected by clicking its label. |
| Multi-select | Multiple nodes can be selected with Ctrl/Shift click. |
| Checkboxes | Optional checkboxes provide hierarchical multi-selection with parent/child propagation. |
| Drag and drop | Nodes can be dragged to a new position within the tree. |
TreeviewItem
ARIA Attributes
| Attribute | Description |
|---|---|
role="treeitem" | The li element rendered for a tree node. |
aria-expanded="true"|\"false" | Announces the expanded state of the node. |
aria-checked="true"|\"false" | Announces the checked state of the node when checkboxes are enabled. |
aria-label | The checkbox input must have an accessible name matching the treeview item text. |
tabindex="-1" | The checkbox input must not be in the tab order. Keyboard interaction is handled by the treeitem. |
aria-selected="true" | when node is selected |
UX Behavior
| Feature | Description |
|---|---|
| Expand / Collapse | A toggle arrow reveals or hides the node's children. |
| Selection | Clicking the label selects the node. |
| Checkbox | An optional checkbox enables hierarchical multi-selection. |
| Drag handle | Allows the node to be dragged to a new position within the tree. |
Testing
The Treeview has been extensively tested automatically with axe-core and manually with the most popular screen readers.
Screen Readers
The Treeview has been tested with the following screen readers and browsers combinations:
| Environment | Tool |
|---|---|
| Firefox | NVDA |
| Chrome | JAWS |
| Microsoft Edge | JAWS |