全部产品

Collapse 折叠面板

可以折叠 / 展开的内容区域。

  • 对复杂区域进行分组和隐藏,保持页面的整洁。
  • 手风琴模式 是一种特殊的折叠面板,只允许单个内容区域展开。

扫码体验

image.png

示例代码

{
  "defaultTitle": "小程序AntUI组件库",
  "usingComponents": {
    "collapse": "mini-antui/es/collapse/index",
    "collapse-item": "mini-antui/es/collapse/collapse-item/index"
  }
}

<view>
  <view class="demo-title">基础用法</view>
  <collapse
    className="demo-collapse"
    collapseKey="collapse1"
    activeKey="{{['item-11', 'item-13']}}"
    onChange="onChange"
  >
    <collapse-item header="标题1" itemKey="item-11" collapseKey="collapse1">
      <view class="item-content content1">
        <view>内容区域</view>
      </view>                
    </collapse-item>
    <collapse-item header="标题2" itemKey="item-12" collapseKey="collapse1">
      <view class="item-content content2">
        <view>内容区域</view>
      </view>
    </collapse-item>
    <collapse-item header="标题3" itemKey="item-13" collapseKey="collapse1">
      <view class="item-content content3">
        <view>内容区域</view>         
      </view>
    </collapse-item>
  </collapse>
  <view class="demo-title">手风琴模式</view>
  <collapse
    className="demo-collapse"
    collapseKey="collapse2"
    activeKey="{{['item-21', 'item-23']}}"
    onChange="onChange"
    accordion="{{true}}"
  >
    <collapse-item header="标题1" itemKey="item-21" collapseKey="collapse2">
      <view class="item-content content1">
        <view>内容区域</view>
      </view>                
    </collapse-item>
    <collapse-item header="标题2" itemKey="item-22" collapseKey="collapse2">
      <view class="item-content content2">
        <view>内容区域</view>
      </view>
    </collapse-item>
    <collapse-item header="标题3" itemKey="item-23" collapseKey="collapse2">
      <view class="item-content content3">
        <view>内容区域</view>         
      </view>
    </collapse-item>
  </collapse>  
</view>

.item-content {
  padding: 14px 16px;
  font-size: 17px;
  color: #333;
  line-height: 24px;
}

.content1 {
  height: 200px;
}

.content2 {
  height: 50px;
}

.content3 {
  height: 100px;
}

.demo-title {
  padding: 14px 16px;
  color: #999;
}

.demo-collapse {
  border-bottom: 1px solid #eee;
}

Page({});

属性

属性名描述类型默认值
activeKey当前激活 tab 面板的 key。Array / String默认无,accordion模式下默认第一个元素
onChange切换面板的回调。(activeKeys: Array): void-
accordion手风琴模式。Booleanfalse
collapseKey唯一标示 collapse 和对应的 collapse-item。Stringfalse

collapse-item

属性名描述类型默认值
itemKey对应 activeKey。String组件唯一标识
header面板头内容。String-
collapseKey唯一标示 collapse 和对应的 collapse-item。Stringfalse

当 Page 中存在多个 collapse 组件时,collapse 和对应的 collapse-item 的 collapseKey 属性为必选值并且必须相等,当 Page 中只有一个 collapse 组件时,collapseKey 不需要提供。