跳到主要内容

Collapse 折叠面板 ​

uni-appH5微信小程序App

跨端折叠面板,支持手风琴模式和 CollapseItem 子项。

何时使用 ​

信息量大但不必全部展示:FAQ、设置分组、长表单分块。

何时不使用 ​

只有 2-3 条短内容时直接平铺;同级互斥切换优先 Tabs。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Collapse 折叠面板 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
modelValuestring[][]展开项的 name 数组,支持 v-model
accordionbooleanfalse手风琴模式:最多同时展开一项

Events ​

名称载荷说明
update:modelValuestring[]展开状态变化时触发,参数为新的 name 数组
changestring[]展开状态变化时触发,参数为新的 name 数组

Slots ​

名称说明
defaultCollapseItem 子项

示例 ​

基础用法 ​

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>