# @cloud-ru/ds-accordion 中文文档

规范地址：https://npmcn.com/package/%40cloud-ru/ds-accordion/

版本：1\.2\.12
npm 元数据更新时间：2026-11-11T15:03:58.731Z
中文译文更新时间：2026-11-11T18:26:16.030Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cloud-ru/ds-accordion
原文对照：https://npmcn.com/package/%40cloud-ru/ds-accordion/?lang=original
项目主页：https://github.com/cloud-ru-tech/snack-v2/tree/master/packages/accordion
源码仓库：https://github.com/cloud-ru-tech/snack-v2

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：521 kB，70 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：7 个
- 首次发布：2026-08-18T12:40:34.250Z
- 最新版本发布：2026-11-11T15:03:58.345Z
- 近 30 天下载量：5315（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：101（近 12 个月 101 个）

## 中文简介

\-=YTET -伊甸园字幕组=- 翻译:.

## 安装

```sh
npm install @cloud-ru/ds-accordion
```

也可以使用：`pnpm add @cloud-ru/ds-accordion`、`yarn add @cloud-ru/ds-accordion`、`bun add @cloud-ru/ds-accordion`

## README

# 手风琴

`@cloud-ru/ds-accordion` -=YTET -伊甸园字幕组=- 翻译:.

Пакет `@cloud-ru/ds-accordion` даёт `Accordion` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 `CollapseBlockPrimary` 编号 : `CollapseBlockSecondary` 编号 : `CollapseBlockTertiary`{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你还得去吗`single` 编号 : `multiple`{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}=======================================================================================================================================================================================================================================.

-   ****手风琴**** - контейнер блоков с `single` 编号 : `multiple` {被控制/未控制 API.
-   ****折叠锁定**** . . . `Primary`, (中文(简体) ), `Secondary`, (中文(简体) ), `Tertiary` {\\fn黑体\\fs20\\shad2\\2ah82\\3ah20\\4ah33\\fscx95\\3ch592001\\be1}你觉得呢.

## Когда

| Задача | Как |
| --- | --- |
| Длинная/настройки | `Accordion` + 键 `CollapseBlockPrimary` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 |
| Двух-/трёхуровневая(раздел-) | Вложенные `Accordion` с `Primary` → `Secondary` → `Tertiary` |
| {\\fn黑体\\fs20\\shad2\\2aH82\\3aH20\\4aH33\\fscx95\\3cH592001\\be1}(英语: | `selectionMode='single'` |
| {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 | `selectionMode='multiple'` |

Когда **не** -=ytet -伊甸园字幕组=- 翻译: `Tabs`。 。 。 .

## Установка

```bash
pnpm add @cloud-ru/ds-accordion
```

```ts
import { Accordion } from '@cloud-ru/ds-accordion'
```

## 图片

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢? {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得怎样.

## 手风琴

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢? \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \*\* \* \* \* \* \* \*\* \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*.

Контейнер,который也 `CollapseBlock*` {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢? – Под – `ToggleGroup` из `@cloud-ru/ds-toggles`说吧 说吧.

### Когда

-   (原始内容存档于2018-10-21). QQ блоков (中文(简体) ).
-   {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `Accordion` внутрь,меняя也 `CollapseBlock*`。 。 。 .

Когда **не** нужен:изолированный也 `CollapseBlock*` без.

### Анатомия

#### 选择模式

说吧 `single` -=ytet -伊甸园字幕组=- 翻译:, `multiple` {\\fn黑体\\fs20\\shad2\\2ah82\\3ah20\\4ah33\\fscx95\\3ch592001\\be1}你觉得呢.

### Примеры

#### 1\. 不受管制者

扩大 (原始内容存档于2019-10-12). Default QQQ; (中文).

```tsx
import { Accordion } from '@cloud-ru/ds-accordion';

import styles from './styles.module.scss';
export function BasicAccordion() {
  return (
    <div className={styles.wrapper}>
      <Accordion expandedDefault='profile'>
        <Accordion.CollapseBlockPrimary id='profile' title='Профиль' subTitle='Контакты и предпочтения' view='outline'>
          Имя, email, аватар.
        </Accordion.CollapseBlockPrimary>
        <Accordion.CollapseBlockPrimary id='security' title='Безопасность' view='outline'>
          Пароль, сессии, 2FA.
        </Accordion.CollapseBlockPrimary>
      </Accordion>
    </div>
  );
}
```

#### 2\. 有控制的+多个

扩展 + 扩展 更改"QQ多"——QQ代号.

```tsx
import { Accordion } from '@cloud-ru/ds-accordion';
import { useState } from 'react';

import styles from './styles.module.scss';
export function MultipleMode() {
  const [expanded, setExpanded] = useState<string[]>(['email']);

  return (
    <div className={styles.wrapper}>
      <Accordion selectionMode='multiple' expanded={expanded} onExpandedChange={next => setExpanded(next ?? [])}>
        <Accordion.CollapseBlockPrimary id='email' title='Email' view='outline'>
          Уведомления на почту.
        </Accordion.CollapseBlockPrimary>
        <Accordion.CollapseBlockPrimary id='push' title='Push' view='outline'>
          Браузерные push-уведомления.
        </Accordion.CollapseBlockPrimary>
        <Accordion.CollapseBlockPrimary id='messenger' title='Мессенджеры' view='outline'>
          Telegram, Slack, Mattermost.
        </Accordion.CollapseBlockPrimary>
      </Accordion>
    </div>
  );
}
```

### 道具

**手风琴**

| Prop | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `children` | `string | number | boolean | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal | null | undefined` | —— 说 |  |
| `expanded` | `string | string[]` | —— 说 | 控制状态 |
| `expandedDefault` | `string | string[]` | —— 说 | Начальное |
| `onExpandedChange` | `((value: string) => void) | ((value: string[]) => void) | undefined` | —— 说 | 被控制着的.. |
| `selectionMode` | `"multiple"` | `"single"` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |

## 折叠锁定

\- 小学(l)、中学(m)、高等教育(s)。 QQ标题 / subTitle / 在Title后 / 视图 / 背景预定义 / chevronPosition.

说吧 `CollapseBlockPrimary`, (中文(简体) ), `CollapseBlockSecondary`, (中文(简体) ), `CollapseBlockTertiary`. . . . . . .

### Когда

-   **`Primary`** (标题大小) `l`)————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————.
-   **`Secondary`** (标题大小) `m`———————————— `Primary`。 。 。 `view='outline'`。 。 。 .
-   **`Tertiary`** (标题大小) `s`)———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————— Без `view` 编号 : `backgroundPredefined` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢.

### Анатомия

#### Содержимое

`children` -=YTET -伊甸园字幕组=- 翻译: {\\fn黑体\\fs20\\shad2\\2aH82\\3aH20\\4aH33\\fscx95\\3cH592001\\be1}♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪ `Typography`。 。 。 。 `regular/body/m`。 。 。 .

#### 视图

说吧 `simple` - плоский фон без рамки, `outline` - с, `elevated` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢.

#### 预定义

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `BACKGROUND_PREDEFINED_FILL` из `@cloud-ru/ds-materials` (как `Card`) (中文(简体) ). – По – `neutralBackground1Level`。 。 。 .

#### 切夫龙投影( 默认) `after`(中文(简体) )

Положение:"раскрытия也.

-   `before` - шеврон от заголовка заголовка заголовка.
-   `after` - шеврон от заголовка заголовка заголовка.

#### 显示 Chevron( 默认) `true`(中文(简体) )

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我...

-   `true` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得怎么样.
-   `false` . . . . . .

### Примеры

#### Цветовые

中立——дефолт. 小学——акцент. {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得怎么样.

```tsx
import { Accordion } from '@cloud-ru/ds-accordion';
import { BACKGROUND_PREDEFINED_FILL } from '@cloud-ru/ds-materials';

import styles from './styles.module.scss';

export function Appearances() {
  return (
    <div className={styles.wrapper}>
      <Accordion>
        <Accordion.CollapseBlockPrimary
          id='neutral'
          backgroundPredefined={BACKGROUND_PREDEFINED_FILL.NeutralBackground1Level}
          title='Neutral'
          view='outline'
        >
          Нейтральный акрил — значение по умолчанию.
        </Accordion.CollapseBlockPrimary>
        <Accordion.CollapseBlockPrimary
          id='primary'
          backgroundPredefined={BACKGROUND_PREDEFINED_FILL.PrimaryBackground}
          title='Primary'
          view='outline'
        >
          Акцентный раздел, выделенный основным цветом.
        </Accordion.CollapseBlockPrimary>
        <Accordion.CollapseBlockPrimary
          id='green'
          backgroundPredefined={BACKGROUND_PREDEFINED_FILL.GreenBackground}
          title='Green'
          view='outline'
        >
          Успех, подтверждённые действия.
        </Accordion.CollapseBlockPrimary>
        <Accordion.CollapseBlockPrimary
          id='red'
          backgroundPredefined={BACKGROUND_PREDEFINED_FILL.RedBackground}
          title='Red'
          view='outline'
        >
          Предупреждение или критическое внимание.
        </Accordion.CollapseBlockPrimary>
      </Accordion>
    </div>
  );
}
```

#### QQ + 题后

Читается:название也.

```tsx
import { Accordion } from '@cloud-ru/ds-accordion';

import styles from './styles.module.scss';
export function ChevronBefore() {
  return (
    <div className={styles.wrapper}>
      <Accordion>
        <Accordion.CollapseBlockSecondary
          id='summary'
          view='outline'
          title='Итого'
          chevronPosition='before'
          afterTitle='1 200 ₽'
        >
          Разбивка платежа по позициям.
        </Accordion.CollapseBlockSecondary>
        <Accordion.CollapseBlockSecondary
          id='delivery'
          view='outline'
          title='Доставка'
          chevronPosition='before'
          afterTitle='бесплатно'
        >
          Курьер по Москве, 2–3 дня.
        </Accordion.CollapseBlockSecondary>
      </Accordion>
    </div>
  );
}
```

#### 题目之后——

计数器 ==== {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得怎么样.

```tsx
import { Accordion } from '@cloud-ru/ds-accordion';
import { Counter } from '@cloud-ru/ds-counter';

import styles from './styles.module.scss';

export function AfterTitle() {
  return (
    <div className={styles.wrapper}>
      <Accordion>
        <Accordion.CollapseBlockPrimary id='inbox' title='Входящие' view='outline' afterTitle={<Counter value={12} />}>
          Непрочитанные сообщения и уведомления.
        </Accordion.CollapseBlockPrimary>
        <Accordion.CollapseBlockPrimary id='archive' title='Архив' view='outline' afterTitle={<Counter value={238} />}>
          Перемещённые из входящих.
        </Accordion.CollapseBlockPrimary>
      </Accordion>
    </div>
  );
}
```

#### 小学 中学 高等教育

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢? {\\fn华文仿宋\\fs16\\1cHD1D1D1}好.

```tsx
import { Accordion } from '@cloud-ru/ds-accordion';

import styles from './styles.module.scss';
export function NestedLevels() {
  return (
    <div className={styles.wrapper}>
      <Accordion>
        <Accordion.CollapseBlockPrimary id='root' title='Платежи' view='outline'>
          <Accordion>
            <Accordion.CollapseBlockSecondary id='sub-cards' view='outline' title='Карты'>
              <Accordion>
                <Accordion.CollapseBlockTertiary id='visa' title='Visa •••• 4242'>
                  Основная карта, истекает 09/28.
                </Accordion.CollapseBlockTertiary>
                <Accordion.CollapseBlockTertiary id='mir' title='МИР •••• 7781'>
                  Зарплатная карта.
                </Accordion.CollapseBlockTertiary>
              </Accordion>
            </Accordion.CollapseBlockSecondary>
            <Accordion.CollapseBlockSecondary id='sub-invoices' view='outline' title='Счета'>
              История операций и выставленные счета.
            </Accordion.CollapseBlockSecondary>
          </Accordion>
        </Accordion.CollapseBlockPrimary>
      </Accordion>
    </div>
  );
}
```

### 道具

**折叠锁定程序**

| Prop | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `afterTitle` | `ReactNode` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢? {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我.. `title`, (中文(简体) ),  
поэтому `title` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢. |
| `backgroundPredefined` | `"blueBackground"` | `"decorTransparent"` | `"greenBackground"` | `"neutralBackground1Level"` | `"orangeBackground"` | `"pinkBackground"` | `"primaryBackground"` | `"redBackground"` | `"transparent"` | `"violetBackground"` | `"yellowBackground"` | `neutralBackground1Level` | ++背景预定义 + 丙烯 (++. `BACKGROUND_PREDEFINED_FILL` 用户 `@cloud-ru/ds-materials`) (中文(简体) ).  
По `material/neutralBackground1Level`。 。 。 . |
| `chevronPosition` | `"after"` | `"before"` | `after` | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你还好吧`before` | `after`(中文(简体) ) |
| `children` | `string | number | boolean | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal | null | undefined` | —— 说 |  |
| `className` | `string` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `component` | `"accordionPrimary"` | `"accordionSecondary"` | `"accordionTertiary"` | —— 说 | Уровень:размер也 |
| `data-test-id` | `string` | —— 说 |  |
| `id` | `string` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `keepMounted` | `boolean` | `false` | {\\fn方正黑体简体\\fs18\\b1\\bord1\\shad1\\3cH2F2F2F}DOM 官方网站 |
| `showChevron` | `boolean` | `true` | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `true`(中文(简体) ) |
| `stopSlotsClickPropagation` | `boolean` | `false` | \# # # # # Title # # # # # # Title # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # |
| `subTitle` | `ReactNode` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `title` | `string` | —— 说 | Заголовок |
| `view` | `"elevated"` | `"outline"` | `"simple"` | `simple` | Визуальный(вариант)`simple`, (中文(简体) ), `outline`, (中文(简体) ), `elevated`(中文(简体) ) |

##### 相关类型

-   `ChevronPosition` =: `"after"` | `"before"`
    
-   `Component` =: `"accordionPrimary"` | `"accordionSecondary"` | `"accordionTertiary"`
    
-   `View` =: `"elevated"` | `"outline"` | `"simple"`
    

## 折叠框

```tsx
import { Accordion } from '@cloud-ru/ds-accordion';
import { Counter } from '@cloud-ru/ds-counter';

import styles from './styles.module.scss';

export function AfterTitle() {
  return (
    <div className={styles.wrapper}>
      <Accordion>
        <Accordion.CollapseBlockPrimary id='inbox' title='Входящие' view='outline' afterTitle={<Counter value={12} />}>
          Непрочитанные сообщения и уведомления.
        </Accordion.CollapseBlockPrimary>
        <Accordion.CollapseBlockPrimary id='archive' title='Архив' view='outline' afterTitle={<Counter value={238} />}>
          Перемещённые из входящих.
        </Accordion.CollapseBlockPrimary>
      </Accordion>
    </div>
  );
}
```

### 道具 `CollapseBlockPropsWithoutComponent`

| Prop | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `afterTitle` | `ReactNode` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢? {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我.. `title`, (中文(简体) ),  
поэтому `title` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢. |
| `backgroundPredefined` | `"blueBackground"` | `"decorTransparent"` | `"greenBackground"` | `"neutralBackground1Level"` | `"orangeBackground"` | `"pinkBackground"` | `"primaryBackground"` | `"redBackground"` | `"transparent"` | `"violetBackground"` | `"yellowBackground"` | —— 说 | ++背景预定义 + 丙烯 (++. `BACKGROUND_PREDEFINED_FILL` 用户 `@cloud-ru/ds-materials`) (中文(简体) ).  
По `material/neutralBackground1Level`。 。 。 . |
| `chevronPosition` | `"after"` | `"before"` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你还好吧`before` | `after`(中文(简体) ) |
| `children` | `string | number | boolean | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal | null | undefined` | —— 说 |  |
| `className` | `string` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `data-test-id` | `string` | —— 说 |  |
| `id` | `string` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `keepMounted` | `boolean` | —— 说 | {\\fn方正黑体简体\\fs18\\b1\\bord1\\shad1\\3cH2F2F2F}DOM 官方网站 |
| `showChevron` | `boolean` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `true`(中文(简体) ) |
| `stopSlotsClickPropagation` | `boolean` | `false` | \# # # # # Title # # # # # # Title # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # |
| `subTitle` | `ReactNode` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `title` | `string` | —— 说 | Заголовок |
| `view` | `"elevated"` | `"outline"` | `"simple"` | —— 说 | Визуальный(вариант)`simple`, (中文(简体) ), `outline`, (中文(简体) ), `elevated`(中文(简体) ) |

#### 相关类型

-   `ChevronPosition` =: `"after"` | `"before"`
    
-   `View` =: `"elevated"` | `"outline"` | `"simple"`
    

## 折叠窗口

```tsx
import { Accordion } from '@cloud-ru/ds-accordion';

import styles from './styles.module.scss';
export function ChevronBefore() {
  return (
    <div className={styles.wrapper}>
      <Accordion>
        <Accordion.CollapseBlockSecondary
          id='summary'
          view='outline'
          title='Итого'
          chevronPosition='before'
          afterTitle='1 200 ₽'
        >
          Разбивка платежа по позициям.
        </Accordion.CollapseBlockSecondary>
        <Accordion.CollapseBlockSecondary
          id='delivery'
          view='outline'
          title='Доставка'
          chevronPosition='before'
          afterTitle='бесплатно'
        >
          Курьер по Москве, 2–3 дня.
        </Accordion.CollapseBlockSecondary>
      </Accordion>
    </div>
  );
}
```

### 道具 `CollapseBlockPropsWithoutComponent`

| Prop | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `afterTitle` | `ReactNode` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢? {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我.. `title`, (中文(简体) ),  
поэтому `title` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢. |
| `backgroundPredefined` | `"blueBackground"` | `"decorTransparent"` | `"greenBackground"` | `"neutralBackground1Level"` | `"orangeBackground"` | `"pinkBackground"` | `"primaryBackground"` | `"redBackground"` | `"transparent"` | `"violetBackground"` | `"yellowBackground"` | —— 说 | ++背景预定义 + 丙烯 (++. `BACKGROUND_PREDEFINED_FILL` 用户 `@cloud-ru/ds-materials`) (中文(简体) ).  
По `material/neutralBackground1Level`。 。 。 . |
| `chevronPosition` | `"after"` | `"before"` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你还好吧`before` | `after`(中文(简体) ) |
| `children` | `string | number | boolean | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal | null | undefined` | —— 说 |  |
| `className` | `string` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `data-test-id` | `string` | —— 说 |  |
| `id` | `string` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `keepMounted` | `boolean` | —— 说 | {\\fn方正黑体简体\\fs18\\b1\\bord1\\shad1\\3cH2F2F2F}DOM 官方网站 |
| `showChevron` | `boolean` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `true`(中文(简体) ) |
| `stopSlotsClickPropagation` | `boolean` | `false` | \# # # # # Title # # # # # # Title # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # |
| `subTitle` | `ReactNode` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `title` | `string` | —— 说 | Заголовок |
| `view` | `"elevated"` | `"outline"` | `"simple"` | —— 说 | Визуальный(вариант)`simple`, (中文(简体) ), `outline`, (中文(简体) ), `elevated`(中文(简体) ) |

#### 相关类型

-   `ChevronPosition` =: `"after"` | `"before"`
    
-   `View` =: `"elevated"` | `"outline"` | `"simple"`
    

## 折叠框

```tsx
import { Accordion } from '@cloud-ru/ds-accordion';

import styles from './styles.module.scss';
export function NestedLevels() {
  return (
    <div className={styles.wrapper}>
      <Accordion>
        <Accordion.CollapseBlockPrimary id='root' title='Платежи' view='outline'>
          <Accordion>
            <Accordion.CollapseBlockSecondary id='sub-cards' view='outline' title='Карты'>
              <Accordion>
                <Accordion.CollapseBlockTertiary id='visa' title='Visa •••• 4242'>
                  Основная карта, истекает 09/28.
                </Accordion.CollapseBlockTertiary>
                <Accordion.CollapseBlockTertiary id='mir' title='МИР •••• 7781'>
                  Зарплатная карта.
                </Accordion.CollapseBlockTertiary>
              </Accordion>
            </Accordion.CollapseBlockSecondary>
            <Accordion.CollapseBlockSecondary id='sub-invoices' view='outline' title='Счета'>
              История операций и выставленные счета.
            </Accordion.CollapseBlockSecondary>
          </Accordion>
        </Accordion.CollapseBlockPrimary>
      </Accordion>
    </div>
  );
}
```

### 道具 `CollapseBlockTertiaryProps`

| Prop | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `afterTitle` | `ReactNode` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢? {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我.. `title`, (中文(简体) ),  
поэтому `title` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢. |
| `chevronPosition` | `"after"` | `"before"` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你还好吧`before` | `after`(中文(简体) ) |
| `children` | `string | number | boolean | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal | null | undefined` | —— 说 |  |
| `className` | `string` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `data-test-id` | `string` | —— 说 |  |
| `id` | `string` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `keepMounted` | `boolean` | —— 说 | {\\fn方正黑体简体\\fs18\\b1\\bord1\\shad1\\3cH2F2F2F}DOM 官方网站 |
| `showChevron` | `boolean` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `true`(中文(简体) ) |
| `stopSlotsClickPropagation` | `boolean` | `false` | \# # # # # Title # # # # # # Title # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # |
| `subTitle` | `ReactNode` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `title` | `string` | —— 说 | Заголовок |

#### 相关类型

-   `ChevronPosition` =: `"after"` | `"before"`

## 常见问题

### @cloud-ru/ds-accordion 是什么？

-=YTET -伊甸园字幕组=- 翻译:\.

### 如何安装 @cloud-ru/ds-accordion？

在项目目录运行 npm install @cloud-ru/ds-accordion，或使用 pnpm add / yarn add / bun add。

### @cloud-ru/ds-accordion 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @cloud-ru/ds-accordion 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @cloud-ru/ds-accordion 可以商用吗？

@cloud-ru/ds-accordion 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @cloud-ru/ds-accordion 的下载量有多少？

根据 npm 官方下载统计，@cloud-ru/ds-accordion 在 2026/10/10 – 2026/11/08 这 30 天内被下载 5,315 次，日均约 177 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cloud-ru/ds-accordion 还在维护吗？

最新版本 1\.2\.12 发布于 2026/11/11（今天）；至今共发布 101 个版本，其中过去 12 个月发布了 101 个；首次发布于 2026/08/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。