Accessibility Features Overview
NOTE
The overall accessibility level of your application depends on the DataGrid 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 DataGrid 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 column fixing feature does not meet this criterion. 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) |
DataGrid does not support Windows High Contrast themes. |
| 501 (Web)(Software) 504.2 (Authoring Tool) 602.3 (Support Docs) |
1.3.2 Meaningful Sequence (Level A) 2.4.3 Focus Order (Level A) |
The column fixing feature in DataGrid does not meet this criterion. |
| 11.5.2.12 Execution of available actions | 2.1.1 Keyboard (Level A) |
|
| - | 2.4.11 Focus Not Obscured (Minimum) (Level AA 2.2 only) | ColumnChooser and HeaderFilter in DataGrid do not meet this criterion. |
| - | 2.5.7 Dragging Movements (Level AA 2.2 only) |
|
| - | 2.5.8 Target Size (Minimum) (Level AA 2.2 only) | Command buttons and icons. |
| - | 4.1.3 Status Messages (Level AA 2.1 and 2.2) | DataGrid summaries when recalculateWhileEditing is enabled. |
| 502.3.3 Row, Column, and Headers | - | DataGrid does not convey information about headers if the column fixing feature is enabled. |
| 504.2.2 PDF Export | - | If you export a DataGrid to PDF, the following issues occur in the resulting document:
|
Keyboard Navigation
A user can use the following keys to interact with the DataGrid component:
| Key | Action |
|---|---|
| ← → ↑ ↓ |
|
| Shift + Mouse Wheel | Scrolls content left/right if horizontal scrolling is active. |
| Enter |
|
| F2 | Switches a cell to the editing state.3 |
| Esc | Cancels changes made in a cell or row, and switches that cell/row back to its normal state. |
| Alt + ↓ | Opens a drop-down editor (a select box4, a calendar5, etc.) in the editing state. |
| Space |
|
| Ctrl + ↑ ↓ | Navigates between a column header, filter row, data area, filter panel, and pager. |
| Ctrl + Space or Ctrl + Click | Selects or clears the selection of the focused row. Previously selected rows remain selected.7 |
| Shift + Space or Shift + Click | Selects or clears the selection of a range of rows between the last selected/deselected and the focused rows.7,8 |
| Ctrl + A | Selects all rows.6,9 |
| Ctrl + F | Focuses the search panel.10 |
| PageUp / PageDown | Navigates to the previous/next page. If scrolling.mode is "virtual", DataGrid scrolls to the value of DataGrid's row viewport height. |
| 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 column sorting settings.11 |
- If the enterKeyAction is "startEdit".
- If the edititng.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.
- The selection.mode should be different from "none".
- The selection.mode should be "multiple".
- 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 should be true.
- The search panel should be visible.
- The sorting.mode should be "multiple".
You can override these shortcuts or create your own. Refer to the following help topic for more information: Custom Keyboard Navigation.
Screen Reader Support
The DataGrid component supports screen readers and complies to WAI-ARIA standards. Known exceptions are listed in the Accessibility Standards Compliance topic.
Feedback