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 с PrimarySecondaryTertiary
Разрешить открыть один блок за раз (FAQ)selectionMode='single'
Разрешить одновременно несколько открытых блоковselectionMode='multiple'

Когда не нужен аккордеон: короткие списки (≤ 3 пунктов), критичный контент, который пользователь не должен пропустить, и навигация — для неё используйте Tabs.

Установка

pnpm add @cloud-ru/ds-accordion
import { Accordion } from '@cloud-ru/ds-accordion'

Figma

Оба компонента следуют одному мастер-файлу Figma. Ссылки на конкретные узлы — на страницах компонентов.