开关 Switch

互斥性的操作控件,用户可打开或关闭某个功能。

基础用法

绑定 v-model 到一个 Boolean 类型的变量。 可以使用 activeColor 属性与 inactiveText 属性来设置开关的背景色

开关类型

通过设置 type 属性即可改变开关的样式。type 可用值为 circle - 圆形(默认)、line - 线性

文字描述

使用 active-text 属性与 inactive-text 属性来设置开关的文字描述, inline-prompt 内部文字描述

自定义开关的值

通过 trueValuefalseValue 可以自定义开关的值

禁用状态

设置 disabled 属性,接受一个Boolean,设置true即可禁用

切换拦截

设置 before-change 函数,函数的返回值将用于判断是否阻止切换

API

Attributes

属性名描述类型默认值
v-model绑定值,必须等于 trueValue 或 falseValue,默认为 Boolean 类型boolean | string | number-
typeswitch形状line | circlecircle
disabled是否禁用booleanfalse
widthswitch 的宽度string | number-
inline-prompt是否开启内部文字描述booleanfalse
active-text激活状态文字描述string-
inactive-text未激活状态文字描述string-
trueValue激活状态绑定的值boolean | string | number-
falseValue未激活状态绑定的值boolean | string | number-
active-color激活状态时的背景颜色string-
inactive-color未激活激活状态时的背景颜色string-
before-changeswitch 状态改变前的钩子, 返回 false 或者返回 Promise 且被 reject 则停止切换() => Promise<boolean> | boolean-

Events

name描述函数类型
changeswitch 状态发生变化时的回调函数(val) => void

Slots

name描述scoped
inline自定义内部文字描述-
loading自定义loading图标-

最后更新时间: