Collapse 折叠面板
uni-appH5微信小程序App
跨端折叠面板,支持手风琴模式和 CollapseItem 子项。
何时使用
信息量大但不必全部展示:FAQ、设置分组、长表单分块。
何时不使用
只有 2-3 条短内容时直接平铺;同级互斥切换优先 Tabs。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string[] | [] | 展开项的 name 数组,支持 v-model |
accordion | boolean | false | 手风琴模式:最多同时展开一项 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string[] | 展开状态变化时触发,参数为新的 name 数组 |
change | string[] | 展开状态变化时触发,参数为新的 name 数组 |
Slots
| 名称 | 说明 |
|---|---|
default | CollapseItem 子项 |
示例
基础用法
vue
<Collapse v-model="s">
<CollapseItem name="intro" title="关于 ruanno-ui">
<Text variant="secondary">一套代码,跑遍 H5 / 微信小程序 / App。</Text>
</CollapseItem>
<CollapseItem name="ai" title="AI 友好">
<Text variant="secondary">组件自带 meta.json 与 llms.txt 契约。</Text>
</CollapseItem>
</Collapse>手风琴模式
vue
<Collapse v-model="s2" accordion>
<CollapseItem name="q1" title="支持哪些平台?">
<Text variant="secondary">H5、微信小程序、App(含 uni-app X)。</Text>
</CollapseItem>
<CollapseItem name="q2" title="如何按需引入?">
<Text variant="secondary">配合 @ruanno-ui/resolver 自动按需。</Text>
</CollapseItem>
</Collapse>禁用项
vue
<Collapse v-model="s3">
<CollapseItem name="open" title="可展开">
<Text variant="secondary">正常内容。</Text>
</CollapseItem>
<CollapseItem name="lock" title="已锁定" disabled>
<Text variant="secondary">不可见内容。</Text>
</CollapseItem>
</Collapse>