# Collapse 组件文档

> **注意**: 本组件为 UI 组件，必须通过 Manager（如 `PropertyPanelManager`）封装后使用，不可直接在业务代码中实例化。

## 1. 组件概述

`BimCollapse` 是一个通用的折叠面板组件，支持手风琴模式、自定义内容和标题。常用于属性面板、设置菜单等场景。

## 2. API 参考

### 2.1 配置项 `CollapseOptions`

```typescript
interface CollapseOptions {
    container: HTMLElement | string;  // 挂载容器
    items: CollapseItemConfig[];      // 面板项列表
    accordion?: boolean;              // 是否开启手风琴模式 (默认 false)
    activeIds?: string[];             // 初始展开的 ID 列表
    bordered?: boolean;               // 是否显示边框 (默认 true)
    ghost?: boolean;                  // 是否幽灵模式 (默认 false)
    className?: string;               // 自定义类名
    onChange?: (activeIds: string[]) => void; // 切换回调
}
```

### 2.2 面板项配置 `CollapseItemConfig`

```typescript
interface CollapseItemConfig {
    id: string;                       // 唯一标识
    title: string;                    // 标题翻译键 (例如 'panel.base')
    content: string | HTMLElement;    // 内容
    icon?: string;                    // 标题图标 (SVG)
    extra?: string | HTMLElement;     // 标题右侧额外内容
    disabled?: boolean;               // 是否禁用
    className?: string;               // 自定义类名
}
```

### 2.3 方法

*   `toggleItem(id: string)`: 切换指定面板的展开/折叠状态。
*   `setLocales()`: 更新组件文本（通常自动调用）。
*   `destroy()`: 销毁组件。

## 3. 使用示例 (在 Manager 中)

```typescript
import { BimCollapse } from '../components/collapse/index';

// 在 Manager 的方法中
const collapse = new BimCollapse({
    container: this.containerElement,
    accordion: true,
    items: [
        {
            id: 'item1',
            title: 'my.title.key', // 翻译键
            content: '<div>Content Here</div>'
        }
    ]
});
```

## 4. 国际化

组件会自动订阅 `localeManager`。
*   **标题**: `config.title` 必须是翻译键。
*   **内容**: 如果内容包含文本，请确保内容生成时已翻译，或内容本身具有响应国际化的能力。