Skip to content
v2.5.0
English
Русский
Documentation

DataGrid

DataGrid is a compound component for keyboard-aware grid navigation across rows and cells.

Labeling

The grid should appear with surrounding context that explains what the cells represent.

Keyboard Behavior

AnnouncementFocus the demo and press a key from the table.
KeyAction
→←Moves the focus to the next or previous cell in the row. Follows the text direction: in right-to-left, → moves to the previous cell. Stops at the row edge unless wrap is set.
↓↑Moves the focus to the cell below or above in the same column.
HomeEndMoves the focus to the first or last cell of the row.
Ctrl + HomeCtrl + EndMoves the focus to the first cell of the first row or the last cell of the last row.
Page DownPage UpMoves the focus to the last or first row in the same column, or by rowDelta rows when it is set.
TabMoves the focus into the grid on the last active cell and then out of it: the whole grid is one tab stop.
Every row is checked in a real browser: Playwright presses the key in Chromium and checks where the focus and the active item land.

Focus Behavior

  • active-cell movement should remain visible
  • interactive content inside cells must not hide the current navigation state

Screen Reader Semantics

  • rows and cells should remain understandable as a grid structure
  • custom cell content should not obscure the meaning of the current position

Accessibility Risks

  • using sparse visual layouts without matching exclusion behavior
  • embedding complex controls that steal focus from the grid model
  • using DataGrid where semantic Table would be clearer