Collapse 折叠面板

xy-collapse 适合承载 FAQ、筛选说明、表单补充配置和可选高级项。它更像“按需展开的内容容器”，不是 Tabs 那种视图切换器。

基础用法

最常见的场景是 FAQ、说明文档或轻量设置项，一次可以展开多项。

基础用法内容折叠

折叠面板用于在有限空间内收纳长内容，支持手风琴和多面板展开模式。

什么是小叶组件库？

小叶组件库面向中后台场景，强调表单录入、浮层交互、排期管理和文档示例闭环。

设计风格为什么更偏业务？

组件默认视觉会优先服务"清晰、可运营、可扩展"的后台页面，而不是追求单一展示感。

是否考虑键盘和语义？

Collapse 的标题区支持键盘触发，并为头部和内容区域建立了 `button / region` 语义关联。

手风琴模式

开启 accordion 后，同一时间只会展开一个面板，适合设置面板和移动端详情页。

手风琴模式Accordion

手风琴模式下，同时只能展开一个面板，适合分步骤的配置场景。

基础设置

用于快速配置名称、负责人、状态和发布日期。

高级设置

用于配置灰度范围、回滚策略、通知对象和更细的权限策略。

审计记录

用于查看最近一次配置变更、操作人和发布时间。

当前展开：base

禁用项与守卫

禁用项不会响应切换；before-collapse 适合在展开前做权限、校验或异步确认。

高级面板已被守卫拦截

公开说明

这部分内容始终允许展开。

高级配置

只有开关打开后，才允许展开这部分内容。

暂未开放

这项被禁用了，不会响应点击和键盘切换。

API

Collapse Attributes

属性	说明	类型	默认值
model-value	当前展开项，手风琴模式下可传单值，非手风琴模式下传数组	CollapseModelValue	[]
accordion	是否启用手风琴模式	boolean	false
expand-icon-position	展开图标位置	CollapseExpandIconPosition	'right'
before-collapse	切换前守卫，返回 false 或 rejected Promise 时阻止切换	CollapseBeforeCollapse	undefined

Collapse Events

事件	说明	参数
update:model-value	展开项变化	CollapseModelValue
change	展开项变化时触发	CollapseModelValue

Collapse Slots

插槽	说明
default	xy-collapse-item 列表

Collapse Exposes

暴露项	说明	类型
activeNames	当前内部维护的展开项列表	CollapseInstance["activeNames"]
setActiveNames	主动写入展开项列表，并同步触发 update:model-value / change	CollapseInstance["setActiveNames"]

CollapseItem Attributes

属性	说明	类型	默认值
title	标题文案	string	''
name	唯一标识，不传时自动生成	CollapseActiveName	undefined
disabled	是否禁用当前项	boolean	false

CollapseItem Slots

插槽	说明
title	自定义标题内容，插槽参数为 CollapseItemTitleSlotProps
default	面板主体内容

CollapseItem Exposes

暴露项	说明	类型
isActive	当前面板项是否处于展开状态	CollapseItemInstance["isActive"]