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

Accordion

Accordion — составной компонент для группы раскрывающихся секций с общей моделью состояния на корне и частями уровня элемента для заголовков, триггеров, иконок и содержимого.

Подписи

Каждый триггер должен ясно описывать секцию, которой управляет. Если секции содержат формы или настройки, текст триггера должен явно отражать эту область.

Поведение клавиатуры

ОбъявлениеПереведите фокус на демо и нажмите клавишу из таблицы.
КлавишаДействие
EnterSpaceРаскрывает или сворачивает секцию триггера в фокусе. Без multiple раскрытие секции сворачивает открытую.
TabShift + TabПереносит фокус на следующий или предыдущий триггер, проходя через фокусируемое содержимое раскрытой секции.
Каждая строка проверена в настоящем браузере: Playwright нажимает клавишу в Chromium и смотрит, где оказались фокус и активный элемент.

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

  • При открытии или закрытии секции фокус должен оставаться на триггере.
  • Раскрытие элемента не должно неожиданно переносить фокус в содержимое.
  • Содержимое аккордеона внутри оверлеев всё равно нужно проверять в реальном стеке.

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

  • Структура заголовка и триггера должна делать иерархию секций понятной.
  • Текст триггера должен оставаться осмысленным без опоры на поворот иконки или визуальную анимацию.
  • Богатое содержимое в раскрытой секции должно читаться как часть той же секции.

Семантика форм

  • Если секция содержит поля формы, подписи и ошибки относятся к этим полям, а не к корню аккордеона.
  • Сворачивание секции не должно скрывать единственное видимое состояние ошибки без другой сводки или индикатора.

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

  • Кликабельные иконки, заменяющие всю поверхность триггера.
  • Размытые подписи триггеров вроде «Подробнее», когда содержимое относится к конкретной задаче.
  • Обязательные ошибки формы, спрятанные в свёрнутых секциях без внешнего сигнала.