city-casereport/miniprogram_npm/tdesign-miniprogram/collapse/README.md
2023-12-06 14:22:42 +08:00

4.4 KiB
Raw Permalink Blame History

title description spline isComponent
Collapse 折叠面板 用于对复杂区域进行分组和隐藏 常用于订单信息展示等 data true

该组件于 0.7.3 版本上线,请留意版本。

引入

全局引入,在 miniprogram 根目录下的app.json中配置,局部引入,在需要引入的页面或组件的index.json中配置。

"usingComponents": {
  "t-collapse": "tdesign-miniprogram/collapse/collapse",
  "t-collapse-panel": "tdesign-miniprogram/collapse-panel/collapse-panel"
}

代码演示

类型

基础折叠面板

{{ base }}

带操作说明

{{ action }}

手风琴模式

{{ accordion }}

样式

卡片折叠面板

{{ theme }}

API

Collapse Props

名称 类型 默认值 说明 必传
default-expand-all Boolean false 默认是否展开全部 N
disabled Boolean - 是否禁用面板展开/收起操作 N
expand-icon Boolean true 展开图标 N
expand-mutex Boolean false 每个面板互斥展开,每次只展开一个面板 N
theme String default 折叠面板风格。可选项default/card N
value Array [] 展开的面板集合。TS 类型:CollapseValue type CollapseValue = Array<string | number>详细类型定义 N
default-value Array undefined 展开的面板集合。非受控属性。TS 类型:CollapseValue type CollapseValue = Array<string | number>详细类型定义 N

Collapse Events

名称 参数 描述
change (value: CollapseValue) 切换面板时触发,返回变化的值

CollapsePanel Props

名称 类型 默认值 说明 必传
content String / Slot - 折叠面板内容 N
disabled Boolean undefined 禁止当前面板展开,优先级大于 Collapse 的同名属性 N
expand-icon Boolean / Slot undefined 当前折叠面板展开图标,优先级大于 Collapse 的同名属性 N
header String / Slot - 面板头内容 N
header-left-icon String / Slot - 面板头左侧图标 N
header-right-content String / Slot - 面板头的右侧区域,一般用于呈现面板操作 N
placement String bottom 0.34.0。选项卡内容的位置。可选项bottom/top N
value String / Number - 当前面板唯一标识,如果值为空则取当前面下标兜底作为唯一标识 N

CollapsePanel 外部样式类

类名 说明
t-class 根节点样式类
t-class-content 内容样式类
t-class-header 头部样式类

CSS 变量

组件提供了下列 CSS 变量,可用于自定义样式。

名称 默认值 描述
--td-collapse-border-color @border-color -
--td-collapse-content-font-size @font-size-base -
--td-collapse-content-line-height 1.5 -
--td-collapse-content-padding 32rpx -
--td-collapse-content-text-color @font-gray-1 -
--td-collapse-extra-font-size @font-size-m -
--td-collapse-header-height 96rpx -
--td-collapse-header-text-color @font-gray-1 -
--td-collapse-header-text-disabled-color @font-gray-4 -
--td-collapse-horizontal-padding 32rpx -
--td-collapse-icon-color @font-gray-3 -
--td-collapse-panel-bg-color @bg-color-container -
--td-collapse-title-font-size @font-size-m -