Skip to main content

TreeList

TreeLists allow users to view and manipulate large amounts of hierarchical data presented as a table.

Accessibility Support

Out of the box, the Telerik and Kendo UI Treelist provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.

The Treelist 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.

TreeList

ARIA Attributes

AttributeDescription
role="toolbar"The toolbar is a collection of command buttons and inputs.
aria-labelClarifies the purpose of the toolbar.
aria-controls=".k-grid-aria-root id"Pointing to the id of the element with role=treegrid.
role="treegrid"The role specifies the element is a TreeGrid.
aria-colcountThe total number of columns.
aria-rowcountThe total number of rows in the table.
role="none"Negates the default semantic role of the <table> element.
role="rowgroup"Required as the owner <table> element has its semantic role removed.
role="row"Required as the owner <table> element has its semantic role removed.
aria-rowindexRow number.
role="columnheader"Required as the owner <table> element has its semantic role removed.
aria-sortPresent if sorting is enabled for that column.
aria-colindexCol number.
aria-haspopup="dialog"Present if the column has a ColumnMenu or FilterMenu.
role="gridcell"Required as the owner <table> element has its semantic role removed.
aria-selected="true"Set on the currently selected row(s) in row selection mode. All cells within the selected row also carry aria-selected=true (without k-selected class).
aria-selected="true"Set on the currently selected cell(s) in cell selection mode. The k-selected class on cells is only applied in cell selection mode, but aria-selected=true is present on cells regardless of selection mode.
aria-expandedSet on the currently expanded row(s).
aria-expandedThe cell containing the expand/collapse toggle also carries aria-expanded matching the row value, as it is the navigable focusable element.
aria-hidden="true"Removes the expand/collapse icon from the accessibility tree.
role="dialog"The filter menu popup has dialog role.
idUnique id linked to the header cell aria-controls attribute.
aria-labelDescriptive label for the filter menu.
role="dialog"The column menu popup has dialog role.
aria-labelDescriptive label for the column menu.
role="button"Column menu items have button role.
tabindex="0"Column menu items are focusable.
aria-expandedExpandable column menu items announce their expanded state.
aria-controlsExpandable items point to the id of the content they control.
role="listbox"The column list is a listbox.
aria-multiselectable="true"The column list supports multiple selections.
aria-labelAccessible name for the column list.
role="option"Column list items are options.
aria-checkedColumn list items announce their checked state.
aria-ownsLocked header rows own cells from the corresponding non-locked header table rows.
aria-ownsLocked content rows own cells from the corresponding non-locked content table rows.
role="none"Non-locked header rows have their semantic role removed when locked columns exist.
role="none"Non-locked content rows have their semantic role removed when locked columns exist.
role="columnheader"Non-locked header cells retain columnheader role so they are announced correctly when owned via aria-owns.
role="gridcell"Non-locked data cells retain gridcell role so they are announced correctly when owned via aria-owns.
aria-labelMust be present in a Drag Row scenario on the cell containing the drag handle.

Keyboard Navigation

TriggerBehavior
EnterIn expandable and non-editable cell - expands or collapses the item.

UX Behavior

FeatureDescription
Expandable rowsRows can have child rows revealed by expanding the parent.
SortingColumn headers are clicked to sort data ascending or descending.
FilteringColumn filter inputs narrow the displayed rows.
Row selectionRows are selected by clicking.

Testing

The Treelist has been extensively tested automatically with axe-core and manually with the most popular screen readers.

Screen Readers

The Treelist has been tested with the following screen readers and browsers combinations:

EnvironmentTool
FirefoxNVDA
ChromeJAWS
Microsoft EdgeJAWS

Resources

Feedback