Skip to main content

TreeView

A TreeView component displays a collapsible tree-like structure for navigating and organizing hierarchical data.

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

AttributeDescription
role="tree"The root list element of the treeview.
role="group"The ul element that wraps child nodes.

Keyboard Navigation

TriggerBehavior
EnterSelects 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.
SpaceChecks the checkbox of the TreeView node.
ArrowUpGoes to the previous tree node. The focus is moved to the previous node and its tabindex is set to 0.
ArrowDownGoes to the next tree node. The focus is moved to the next node and its tabindex is set to 0.
ArrowLeftIf 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.
ArrowRightIf 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.
HomeMoves the focus to the first node in the tree without opening or closing a node.
EndMoves the focus to the last node in the tree that is focusable without opening a node.
Control/Cmd(Mac) + EnterSelects the focused item. When the item is already selected, it gets deselected.
Printable CharactersTyping M or any other printable character focuses the next or the first item in the list.

UX Behavior

FeatureDescription
Expand / CollapseNodes with children can be expanded to reveal them.
SelectionA node is selected by clicking its label.
Multi-selectMultiple nodes can be selected with Ctrl/Shift click.
CheckboxesOptional checkboxes provide hierarchical multi-selection with parent/child propagation.
Drag and dropNodes can be dragged to a new position within the tree.

TreeviewItem

ARIA Attributes

AttributeDescription
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-labelThe 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

FeatureDescription
Expand / CollapseA toggle arrow reveals or hides the node's children.
SelectionClicking the label selects the node.
CheckboxAn optional checkbox enables hierarchical multi-selection.
Drag handleAllows 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:

EnvironmentTool
FirefoxNVDA
ChromeJAWS
Microsoft EdgeJAWS

Resources

Feedback