折叠面板 Collapse

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

使用

API

安装使用

{
  // 原生小程序
  "usingComponents": {
    "ti-collapse": "@titian-design/weapp/collapse/index",
    "ti-collapse-item": "@titian-design/weapp/collapse-item/index",
  },
  // titan-cli搭建的项目
  "usingComponents": {
    "ti-collapse": "platform://titian-mp/ti-collapse",
    "ti-collapse-item": "platform://titian-mp/ti-collapse-item"
  }
}

用法示例

基本使用

- 标题A下的内容 -- 标题B下的内容 -

copy

code

<ti-collapse>
  <ti-collapse-item title="标题文字A">- 标题A下的内容 -</ti-collapse-item>
  <ti-collapse-item title="标题文字B">- 标题B下的内容 -</ti-collapse-item>
</ti-collapse>

设置图标

- 标题A下的内容 -- 标题B下的内容 -

copy

code

<ti-collapse icon="share-wechat-moments">
  <ti-collapse-item title="标题文字A">- 标题A下的内容 -</ti-collapse-item>
  <ti-collapse-item title="标题文字B">- 标题B下的内容 -</ti-collapse-item>
</ti-collapse>

禁用

- 标题A下的内容 -- 标题B下的内容 -

copy

code

<ti-collapse disabled>
  <ti-collapse-item title="标题文字A">- 标题A下的内容 -</ti-collapse-item>
  <ti-collapse-item title="标题文字B">- 标题B下的内容 -</ti-collapse-item>
</ti-collapse>

事件监听

- 标题A下的内容 -- 标题B下的内容 -

- 标题A下的内容 -- 标题B下的内容 -

• App.wxml
• index.js

code

copy

code

<ti-collapse bind:close="handleClose" bind:open="handleOpen" bind:change="handleChange">
  <ti-collapse-item title="标题文字A">- 标题A下的内容 -</ti-collapse-item>
  <ti-collapse-item title="标题文字B">- 标题B下的内容 -</ti-collapse-item>
</ti-collapse>

<ti-collapse bind:close="handleClose" bind:open="handleOpen" bind:change="handleChange" repel>
  <ti-collapse-item title="标题文字A">- 标题A下的内容 -</ti-collapse-item>
  <ti-collapse-item title="标题文字B">- 标题B下的内容 -</ti-collapse-item>
</ti-collapse>

copy

code

Page({
  handleChange(e) {
    console.log('切换', e.detail);
  },
  handleOpen(e) {
    console.log('打开', e.detail);
  },
  handleClose(e) {
    console.log('关闭', e.detail);
  },
});

手风琴模式

- 标题A下的内容 -- 标题B下的内容 -

copy

code

<ti-collapse repel>
  <ti-collapse-item title="标题文字A">- 标题A下的内容 -</ti-collapse-item>
  <ti-collapse-item title="标题文字B">- 标题B下的内容 -</ti-collapse-item>
</ti-collapse>

设置默认值

- 标题A下的内容 -- 标题B下的内容 -

copy

code

<ti-collapse value="{{[0]}}">
  <ti-collapse-item title="标题文字A">- 标题A下的内容 -</ti-collapse-item>
  <ti-collapse-item title="标题文字B">- 标题B下的内容 -</ti-collapse-item>
</ti-collapse>

使用 options 属性创建面板

• App.wxml
• index.js

code

copy

code

<ti-collapse options="{{options}}" />

copy

code

Page({
  data: {
    options: [
      { title: '标题文字A', content: '- 标题A下的内容 -' },
      { title: '标题文字B', content: '- 标题B下的内容 -' },
    ],
  },
});

ti-collapse API

属性 Properties

名称	类型	必填	默认值	说明	备注
value	Array<string | number> | string | number	否	null	选中值	-
options	Options	否	[]		-
icon	string	否	-	全局设置左侧 icon	-
right-icon	string	否	-	全局设置右侧 icon	-
disabled	boolean	否	-	全局设置是否禁用	-
repel	boolean	否	-	是否手风琴模式	-
divider	boolean	否	-	是否展示分割线	-
clickable	boolean	否	-	开启点击反馈	-
ext-option-style	string	否	-	子项容器样式

Options

详情可参考 [ti-cell 属性](详情可参考 ti-cell 属性

interface Options {
  "clickable"?: boolean;
  "desc"?: string;
  "disabled"?: boolean;
  "divider"?: boolean;
  "icon"?: string;
  "label"?: string;
  "rightIcon"?: string;
  "title": string;
  "content": string;
  "value"?: string | number;
}

事件 Events

名称	参数	描述	备注
bind:change	(e: WechatMiniprogram.CustomEvent<string | number | Array<string | number>>) => void	折叠面板选中值	当为手风琴模式时返回值为 string | number，否则为 Array<string | number>
bind:open	(e: WechatMiniprogram.CustomEvent<string | number>) => void	折叠面板展开事件	-
bind:close	(e: WechatMiniprogram.CustomEvent<string | number>) => void	折叠面板关闭事件	-

可扩展样式名 External Class

类名	说明	备注
ext-option-class	子项容器样式
ext-option-content-class	子项容器折叠区样式

ti-collapse-item API

属性 Properties

名称	类型	必填	默认值	说明	备注
value	string	否	null	用来匹配父类 value，判断当前面板是否需要被展开，如果不传入，默认使用下标(index)	-
title	string	否	[]	标题文字	-
desc	string	否	null	内容文字	-
icon	string	否	false	左侧 icon	-
right-icon	string	否	null	右侧 icon	-
disabled	boolean	否	false	是否禁用	-
use-right-icon-slot	boolean	否	false	是否使用右侧 icon 插槽	-
ext-style	string	否	''	容器样式	-
divider	boolean	否	-	是否展示分割线	-
clickable	boolean	否	-	开启点击反馈	-
use-cell-slot	boolean	否	-	常显示区域即cell组件部分区域，使用自定义插槽	-

插槽 Slots

名称	说明	备注
cell	常显示区域插槽，配合use-cell-slot使用	-
title	文档	-
icon	左侧 icon	-
right-icon	右侧 icon	-
desc	内容	-
default	内容区默认插槽	-

可扩展样式名 External Class

类名	说明	备注
ext-class	容器样式

CSS 变量 CSS Variables

变量	默认值	说明	备注
--collapse-item-padding-v	-	折叠区垂直方向的内边距	-
--collapse-item-padding-h	-	折叠区水平方向的内边距	-
--collapse-item-text-color	-	折叠区文本颜色	-
--collapse-item-icon-color	-	右侧 icon 颜色	-
--collapse-item-cubic-bezier	-	动画执行速度	-
--collapse-item-cell-padding-v	-	同 Cell 组件 --cell-padding-v	-
--collapse-item-cell-padding-h	-	同 Cell 组件 --cell-padding-h	-
--collapse-item-cell-text-color	-	同 Cell 组件 --cell-text-color	-
--collapse-item-cell-title-text-color	-	同 Cell 组件 --cell-title-text-color	-
--collapse-item-cell-label-text-color	-	同 Cell 组件 --cell-label-text-color	-
--collapse-item-cell-desc-text-color	-	同 Cell 组件 --cell-desc-text-color	-
--collapse-item-cell-bg-color	-	同 Cell 组件 --cell-bg-color	-
--collapse-item-cell-value-text-color	-	同 Cell 组件 --cell-right-icon-color	-
--collapse-item-cell-text-disabled-color	-	同 Cell 组件 --cell-text-disabled-color	-
--collapse-item-cell-hover-bg-color	-	同 Cell 组件 --cell-hover-bg-color	-
--collapse-item-line-height	theme.lineHeight.single.t4	内容区文字行高	-
--collapse-item-font-weight	theme.fontWeight.regular	内容区文字字重	-
--collapse-item-font-size	theme.fontSize.t4	内容区文字大小	-
--collapse-padding-h	28px	内容区横向间距	-
--collapse-padding-v	46px	内容区垂直间距	-