Files
HuajisheTools/HuajisheCheckChaoXing/miniprogram_npm/tdesign-miniprogram/collapse/README.md
2025-10-01 10:01:52 +08:00

5.6 KiB
Raw Blame History

title, description, spline, isComponent
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"
}

代码演示

在开发者工具中预览效果

Tips: 请确保开发者工具为打开状态。导入开发者工具后依次执行npm i > 构建npm包 > 勾选 "将JS编译成ES5"

类型

基础折叠面板

{{ base }}

带操作说明

{{ action }}

手风琴模式

{{ accordion }}

样式

卡片折叠面板

{{ theme }}

API

Collapse Props

名称 类型 默认值 描述 必传
style Object - 样式 N
custom-style Object - 样式,一般用于开启虚拟化组件节点场景 N
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

名称 类型 默认值 描述 必传
style Object - 样式 N
custom-style Object - 样式,一般用于开启虚拟化组件节点场景 N
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 External Classes

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

CSS Variables

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

名称 默认值 描述
--td-collapse-border-color @border-level-1-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 @text-color-primary -
--td-collapse-extra-font-size @font-size-m -
--td-collapse-header-height auto -
--td-collapse-header-text-color @text-color-primary -
--td-collapse-header-text-disabled-color @text-color-disabled -
--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 -