Перейти к содержимому
v2.5.0
English
Русский
Документация

DataGrid

DataGrid — составной компонент для навигации по строкам и ячейкам сетки с клавиатуры.

Именование

Сетка должна сопровождаться контекстом, который объясняет, что содержат ячейки.

Работа с клавиатурой

ОбъявлениеПереведите фокус на демо и нажмите клавишу из таблицы.
КлавишаДействие
→←Переносит фокус на следующую или предыдущую ячейку строки. Следует направлению текста: в right-to-left → ведёт к предыдущей ячейке. Останавливается на краю строки, если не задан wrap.
↓↑Переносит фокус на ячейку ниже или выше в той же колонке.
HomeEndПереносит фокус на первую или последнюю ячейку строки.
Ctrl + HomeCtrl + EndПереносит фокус на первую ячейку первой строки или последнюю ячейку последней строки.
Page DownPage UpПереносит фокус на последнюю или первую строку в той же колонке, а при заданном rowDelta — на столько строк.
TabВводит фокус в сетку на последнюю активную ячейку и затем выводит из неё: вся сетка — одна остановка табуляции.
Каждая строка проверена в настоящем браузере: Playwright нажимает клавишу в Chromium и смотрит, где оказались фокус и активный элемент.

Поведение фокуса

  • перемещение активной ячейки должно оставаться видимым
  • интерактивное содержимое внутри ячеек не должно скрывать текущее состояние навигации

Семантика для скринридеров

  • строки и ячейки должны оставаться понятными как структура сетки
  • кастомное содержимое ячеек не должно затемнять смысл текущей позиции

Риски доступности

  • разреженная визуальная раскладка без соответствующей логики исключений
  • встраивание сложных контролов, которые перехватывают фокус у модели сетки
  • использование DataGrid там, где семантическая Table была бы понятнее