TUI

Collapse 折叠面板
用于展示可折叠的内容区域,支持平滑展开与收起动画,支持自定义折叠高度和动态内容更新。
基础用法
点击按钮切换折叠状态,默认折叠高度为 0,动画时长 300ms。
示例代码
vue
自定义折叠高度
折叠时保留 40px 高度,保持折叠面板依然可见部分内容。
示例代码
vue
动态内容更新展开高度
动态增加内容时,通过 forceOnExpand 控制是否强制触发回流更新展开高度。
示例代码
vue
自定义插槽内容
通过默认插槽传入复杂结构,折叠面板可以承载任意组件或元素。
示例代码
vue
属性 Props
属性名
说明
类型
可选值
默认值
版本说明
modelValue
是否展开,支持使用 v-model 双向绑定
Boolean
-
true
collapsedHeight
折叠状态下面板的高度(px)
number
-
0
transitionDuration
折叠/展开动画过渡时间(毫秒)
number
-
300
v-model:forceOnExpand
展开状态下更新折叠面板高度
number
-
300
插槽 Slots
插槽名
说明
版本说明
default
自定义折叠面板内容
方法 Functions
方法名
说明
参数
返回值
版本说明
toggleCollapse
切换折叠展开状态
-
-
getCollapseHeight
获取当前容器的实时高度(px)
-
number
updateExpandedHeight
更新展开状态的高度,仅在展开状态下生效
-
number
expandAndUpdateHeight
展开并更新该状态下高度
-
-
基础用法
自定义折叠高度
动态内容更新展开高度
自定义插槽内容
属性 Props
插槽 Slots
方法 Functions