water_xcx/miniprogram_npm/tdesign-miniprogram/switch
Cc a25b49fd6d 初始化:小程序同步 2025-04-15 15:44:51 +08:00
..
README.md 初始化:小程序同步 2025-04-15 15:44:51 +08:00
_var.wxss 初始化:小程序同步 2025-04-15 15:44:51 +08:00
props.d.ts 初始化:小程序同步 2025-04-15 15:44:51 +08:00
props.js 初始化:小程序同步 2025-04-15 15:44:51 +08:00
switch.d.ts 初始化:小程序同步 2025-04-15 15:44:51 +08:00
switch.js 初始化:小程序同步 2025-04-15 15:44:51 +08:00
switch.json 初始化:小程序同步 2025-04-15 15:44:51 +08:00
switch.wxml 初始化:小程序同步 2025-04-15 15:44:51 +08:00
switch.wxss 初始化:小程序同步 2025-04-15 15:44:51 +08:00
type.d.ts 初始化:小程序同步 2025-04-15 15:44:51 +08:00
type.js 初始化:小程序同步 2025-04-15 15:44:51 +08:00

README.md

title description spline isComponent
Switch 开关 用于控制某个功能的开启和关闭。 form true

引入

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

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

代码演示

基础开关

{{ base }}

开关状态

{{ status }}

受控用法

<t-switch value="{{value}}" bindchange="onChange"></t-switch>

非受控用法

<t-switch defaultValue="{{value}}"></t-switch>

API

Switch Props

名称 类型 默认值 说明 必传
colors Array - 自定义颜色,[打开时的颜色,关闭时的颜色]。组件默认颜色为 ['#0052d9', 'rgba(0, 0, 0, .26']。示例:[blue, gray]。TS 类型:string[] N
custom-value Array - 开关内容,[打开时的值,关闭时的值]。默认为 [true, false]。示例:[1, 0]。TS 类型:Array<SwitchValue> N
disabled Boolean false 是否禁用组件 N
label String '' 开关的标签 N
loading Boolean false 是否处于加载中状态 N
size String medium 开关尺寸。可选项small/medium/large N
value String / Number / Boolean undefined 开关值。TS 类型:SwitchValue `type SwitchValue = string number
default-value String / Number / Boolean undefined 开关值。非受控属性。TS 类型:SwitchValue `type SwitchValue = string number

Switch Events

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