Accessibility
The TreeView is accessible by screen readers and provides full WAI-ARIA support.
WAI-ARIA Support
The component supports both single and multiple selection. When the selection is multiple
, set the aria-multiselectable
property to true
.
When the draggable
property is set to true
, the TreeView does not automatically apply the WAI-ARIA drag-and-drop functionality to its items by implementing the respective aria-grabbed
and aria-dropeffect
attributes. The reason for this behavior is that the component is not aware of the full context—for example, the items to which a dragged item can be dropped. However, you can apply aria-grabbed
and aria-dropeffect
by using the custom item rendering that is provided by the itemRender
property of the TreeView.
Depending on the checked
, expanded
, and selected
item fields, the TreeView sets the aria-checked
, aria-expanded
, and aria-selected
attributes to its items.
The TreeView uses the tree
role.
To move the focus to the current keyboard navigation position, the TreeView utilizes the tabindex
approach.
The TreeView also follows the WAI-ARIA best practices for implementing the keyboard navigation for its component role and is tested against the popular screen readers.
Section 508
The TreeView is compliant with the Section 508 requirements.
Limitations
The following issues are related to the WAI-ARIA support limitations of browsers and screen readers:
- Internet Explorer 10 and 11 work best with the Jaws screen reader. Other readers are not supported very well. For more information, refer to issue 817699.
- Microsoft Edge works best with Microsoft Narrator screen reader. For more information, refer to issue 8571350.