Accessibility · Library v2.6.0
DataGrid WAI-ARIA Support
DataGrid exposes row, column, sort and loading information. Keyboard behavior depends on enabled features; range selection adds cell navigation.
Roles, states and properties
These describe the installed implementation. ARIA communicates meaning; keyboard handlers and application code provide the interaction.
| Element | Semantics | Behavior |
|---|---|---|
| Data container | grid, aria-label, aria-rowcount, aria-colcount | The caption supplies the grid name; otherwise it is “Data grid”. |
| Headers and data cells | rowgroup, row, columnheader, gridcell, aria-sort | Sort state is exposed on sortable headers. |
| Selection and editing | aria-selected, aria-invalid, aria-describedby | Range selection and built-in validation expose state where those features are enabled. |
| Loading and updates | aria-busy; polite status region | The wrapper exposes loading and the live region announces supported actions. |
Current limitations
- The default grid does not implement the complete APG single-tab-stop interaction model. Range navigation is opt-in and does not cover every header, toolbar and custom template.
- Grouped rows, virtual windows and custom detail content require application-level keyboard and assistive-technology testing. Do not assume unrendered rows can be read by a screen reader.
This reference is based on the shipped source. It is not a WCAG conformance certificate or a claim that every browser and screen reader combination has been tested.
Compare your workflow with the W3C authoring pattern. The pattern describes the target interaction, not a guarantee of current component support.