Skip to content

开关 Switch

没事打开他干嘛。

基本用法

使用 v-model 属性进行双向绑定,否则开关将不会改变状态。

大小

使用 size 属性设置开关的大小,提供 smallmediumlarge 三种尺寸。

形状

使用 shape 属性改变开关的形状。

round - 圆形开关square - 方形开关

颜色

使用 checked-color 属性和 unchecked-color 属性自定义开关的颜色。

图标

使用 checked-icon 属性和 unchecked-icon 属性自定义开关上显示的图标。

加载中

添加 loading 属性,开关会显示加载状态。

异步切换

设置 beforeChange 属性为一个函数,函数的返回值即为是否切换。

禁用

添加 disabled 属性,开关会被禁用。

API

Switch 属性

属性类型默认值说明
modelValue (v-model)boolean绑定值
sizestringmedium开关大小
shapestringround开关形状
checkedColorstring开关开启时的颜色
uncheckedColorstring开关关闭时的颜色
checkedIconstring开关开启时显示的图标
uncheckedIconstring开关关闭时显示的图标
loadingbooleanfalse加载状态
disabledbooleanfalse禁用状态
beforeChangefunction开关状态改变前的回调

Switch 事件

事件名说明回调参数
change开关状态发生变化时的回调(value: boolean) => value