KeCheng

2.2 KiB

Raw Permalink Blame History Unescape Escape

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

title	description	spline	isComponent
Cascader 级联选择器	级联选择器适用于有清晰层级结构的数据集合，用户可以通过逐级查看并选择。	form	true

该组件于 0.23.0 版本上线，请留意版本。

引入

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

"usingComponents": {
  "t-cascader": "tdesign-miniprogram/cascader/cascader"
}

代码演示

基础用法

选项卡风格

进阶

带初始值

自定义 keys

使用次级标题

API

Cascader Props

名称	类型	默认值	说明	必传
close-btn	Boolean / Slot	true	关闭按钮	N
keys	Object	-	用来定义 value / label 在 `options` 中对应的字段别名。TS 类型：`KeysType`	N
options	Array	[]	可选项数据源。TS 类型：`Array<CascaderOption>`	N
sub-titles	Array	[]	每级展示的次标题。TS 类型：`Array<string>`	N
theme	String	step	展示风格。可选项：step/tab	N
title	String / Slot	-	标题	N
value	String / Number	null	选项值	N
default-value	String / Number	undefined	选项值。非受控属性	N
visible	Boolean	false	是否展示	N

Cascader Events

名称	参数	描述
change	`(value: string \| number, selectedOptions: string[])`	`1.0.1`。值发生变更时触发
close	`(trigger: TriggerSource)`	`1.0.1`。关闭时触发。详细类型定义。 `type TriggerSource = 'overlay' \| 'close-btn' \| 'finish'`
pick	`(value: string \| number, index: number)`	`1.0.1`。选择后触发

2.2 KiB Raw Permalink Blame History Unescape Escape

引入