Accordion
Пакет @cloud-ru/ds-accordion даёт контейнер Accordion и три уровня раскрываемых блоков CollapseBlockPrimary / CollapseBlockSecondary / CollapseBlockTertiary. Контейнер отвечает за режим выбора (single / multiple) и controlled/uncontrolled состояние, блоки — за внешний вид и иерархию на странице.
- Accordion — контейнер раскрываемых блоков с режимами
single/multipleи controlled/uncontrolled API. - CollapseBlock — раскрываемые блоки трёх уровней:
Primary,Secondary,Tertiary— для иерархии разделов на странице.
Когда использовать
| Задача | Как решить |
|---|---|
| Длинная форма / настройки с логическими секциями | Accordion + CollapseBlockPrimary на каждый раздел |
| Двух- / трёхуровневая иерархия (раздел → подраздел → деталь) | Вложенные Accordion с Primary → Secondary → Tertiary |
| Разрешить открыть один блок за раз (FAQ) | selectionMode='single' |
| Разрешить одновременно несколько открытых блоков | selectionMode='multiple' |
Когда не нужен аккордеон: короткие списки (≤ 3 пунктов), критичный контент, который пользователь не должен пропустить, и навигация — для неё используйте Tabs.
Установка
pnpm add @cloud-ru/ds-accordion
import { Accordion } from '@cloud-ru/ds-accordion'
Figma
Оба компонента следуют одному мастер-файлу Figma. Ссылки на конкретные узлы — на страницах компонентов.