Accessibility Features Overview
NOTE
The overall accessibility level of your application depends on the TreeList features that you use.
| Accessibility Requirement | Support Level |
|---|---|
| Right-to-Left Support | |
| Keyboard Navigation Support | |
| Screen Reader Support | |
| Contrast Color Theme | |
| Mobile Device Support | |
| Lighthouse Accessibility Validation | |
| Axe Accessibility Validation | |
| WAVE Accessibility Validation | |
| Section 508 Support | |
| WCAG 2.x Support |
- - All component features meet the requirement
- - Some component features may not meet the requirement
- - Accessibility requirement is not supported
Accessibility Standards Compliance
The TreeList component meets a variety of Section 508 and WCAG 2.x compliance standards. Known exceptions:
| Section 508 criteria | WCAG 2.x criteria | Exception description |
|---|---|---|
| 501 (Web)(Software) 504.2 (Authoring Tool) 602.3 (Support Docs) |
1.1.1 Non-text Content (Level A) | Drag icons do not have alt and aria-label attributes. |
| 501 (Web)(Software) 504.2 (Authoring Tool) 602.3 (Support Docs) |
1.3.1 Info and Relationships (Level A) | The filter menu button in filter row does not supply any accessibility information. |
| 501 (Web)(Software) 504.2 (Authoring Tool) 602.3 (Support Docs) |
1.4.3 Contrast (Minimum) (Level AA) 1.4.11 Non-text Contrast (Level AA 2.1 and 2.2) |
TreeList does not support Windows High Contrast themes. |
| 11.5.2.12 Execution of available actions | 2.1.1 Keyboard (Level A) | Keyboard navigation is not supported for ColumnChooser items in 'drag' mode. |
| - | 2.5.7 Dragging Movements (Level AA 2.2 only) |
|
| - | 2.5.8 Target Size (Minimum) (Level AA 2.2 only) |
|
| 11.5.2.15 Change notification | 4.1.3 Status Messages (Level AA 2.1 and 2.2) | TreeList summaries when recalculateWhileEditing is enabled. |
Keyboard Navigation
A user can use the following keys to interact with the TreeList component:
| Key | Action |
|---|---|
| ← → ↑ ↓ |
|
| Shift + Mouse Wheel | Scrolls the content left/right if the horizontal scrolling is taking place. |
| Enter |
|
| F2 | Switches a cell to the editing state.3 |
| Esc | Cancels changes made in a cell or row and switches it back to its normal state. |
| Alt + ↓ | Opens a drop-down editor (a select box4, a calendar5, etc.) in the editing state. |
| Space | Selects the focused row. In multiple selection mode, also clears the selection.6 |
| Ctrl + Space or Ctrl + Click | Сlears the selection of the focused row in single selection mode. |
| Shift + Space | Selects or clears the selection of a range of rows between the last selected or deselected and the focused rows.7,8,9 |
| Ctrl + A | Selects all rows.6,10 |
| Ctrl + F | Focuses the search panel.11 |
| PageUp / PageDown | Navigates to the previous/next page. |
| Tab / Shift + Tab | Moves the focus one element forward/back. Focuses the first/last element in the next/previous row if there are no more elements in the current row. |
|
Shift + Click / Ctrl + Click on a column header |
Applies/clears sorting settings of the column.12 |
| Ctrl + → / Ctrl + ← | Expands/collapses the focused row. |
| Ctrl + ↑ / Ctrl + ↓ | Navigates between a column header, filter row, data area, filter panel, and pager. |
- If the enterKeyAction is "startEdit".
- If the editing.mode is "cell" or "batch" and the enterKeyAction is "moveFocus".
- The editing.mode should be "cell" or "batch".
- A select box appears in a cell of a lookup column.
- A calendar appears in a data cell when a column contains "date" type data.
- selection.mode must be different from "none".
- selection.mode must be "multiple".
- selection.recursive must be false.
- If the scrolling.mode is "virtual", the rows should be visible simultaneously. If the mode is "standard", the rows should be on one page.
- selection.allowSelectAll must be true.
- The search panel must be visible.
- sorting.mode must be "multiple".
You can override these shortcuts or create your own shortcuts using the onKeyDown event handler.
Screen Reader Support
The TreeList component supports screen readers and complies to WAI-ARIA standards. Known exceptions are listed in the Accessibility Standards Compliance topic.
Feedback