---
url: https://ain.hmgf.hxcn.space/contribution/project-components/accordion.md
description: 使用 Accordion 与 AccordionItem 构建可折叠内容区域。
---

# Accordion 组件

`Accordion` 适合 FAQ、安装步骤、参数说明等“需要折叠/展开”的长内容。

## 基础用法

```md
<Accordion type="single" default-value="install">
  <AccordionItem value="install" title="安装依赖">...</AccordionItem>
  <AccordionItem value="dev" title="本地开发">...</AccordionItem>
</Accordion>
```

## 多开模式

## Props

### Accordion

| 参数 | 类型 | 默认值 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `type` | `single \| multiple` | `multiple` | 单开或多开。 | `type="single"` |
| `collapsible` | `boolean` | `true` | `single` 模式下是否允许全部收起。 | `:collapsible="false"` |
| `defaultValue` | `string \| string[]` | `''` | 初始展开项。 | `default-value="install"` |

### AccordionItem

| 参数 | 类型 | 默认值 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `value` | `string` | `''` | 项唯一值，不传时按 `title` 自动生成。 | `value="install"` |
| `title` | `string` | - | 标题（必填）。 | `title="安装依赖"` |
| `icon` | `string` | `''` | 标题图标。 | `icon="mdi:download-circle-outline"` |
| `defaultOpen` | `boolean` | `false` | 初始是否展开。 | `:default-open="true"` |
| `disabled` | `boolean` | `false` | 禁用状态。 | `:disabled="true"` |