开关 Switch
没事打开他干嘛。
基本用法
使用 v-model
属性进行双向绑定,否则开关将不会改变状态。
大小
使用 size
属性设置开关的大小,提供 small
、medium
、large
三种尺寸。
形状
使用 shape
属性改变开关的形状。
round
- 圆形开关,square
- 方形开关。
颜色
使用 checked-color
属性和 unchecked-color
属性自定义开关的颜色。
图标
使用 checked-icon
属性和 unchecked-icon
属性自定义开关上显示的图标。
加载中
添加 loading
属性,开关会显示加载状态。
异步切换
设置 beforeChange
属性为一个函数,函数的返回值即为是否切换。
禁用
添加 disabled
属性,开关会被禁用。
API
Switch 属性
属性 | 类型 | 默认值 | 说明 |
---|---|---|---|
modelValue (v-model) | boolean | — | 绑定值 |
size | string | medium | 开关大小 |
shape | string | round | 开关形状 |
checkedColor | string | — | 开关开启时的颜色 |
uncheckedColor | string | — | 开关关闭时的颜色 |
checkedIcon | string | — | 开关开启时显示的图标 |
uncheckedIcon | string | — | 开关关闭时显示的图标 |
loading | boolean | false | 加载状态 |
disabled | boolean | false | 禁用状态 |
beforeChange | function | — | 开关状态改变前的回调 |
Switch 事件
事件名 | 说明 | 回调参数 |
---|---|---|
change | 开关状态发生变化时的回调 | (value: boolean) => value |