KeCheng

2.4 KiB

Raw 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
Switch 开关	用于控制某个功能的开启和关闭。	form	true

引入

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

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

代码演示

基础开关

带描述开关

自定义颜色

开关状态

尺寸

API

Switch Props

名称	类型	默认值	说明	必传
custom-value	Array	[true, false]	用于自定义开关的值，[打开时的值，关闭时的值]。默认为 [true, false]。示例：[1, 0]、['open', 'close']。TS 类型：`Array<SwitchValue>`	N
disabled	Boolean	false	是否禁用组件	N
icon `v0.27.0`	Array	[]	开关的图标；[打开时的图标，关闭时的图标]。TS 类型：`string[]`	N
label `v0.27.0`	Array	[]	开关的标签；[打开时的标签，关闭时的标签]。TS 类型：`string[]`	N
loading `v0.27.0`	Boolean	false	是否处于加载中状态	N
size `v0.27.0`	String	medium	开关尺寸。可选项：small/medium/large	N
value	String / Number / Boolean	null	开关值。TS 类型：`SwitchValue` `type SwitchValue = string \| number \| boolean`。详细类型定义	N
default-value	String / Number / Boolean	undefined	开关值。非受控属性。TS 类型：`SwitchValue` `type SwitchValue = string \| number \| boolean`。详细类型定义	N

Switch Events

名称	参数	描述
change	`(value: SwitchValue)`	数据发生变化时触发

2.4 KiB Raw Blame History Unescape Escape

引入