开关 Switch
互斥性的操作控件,用户可打开或关闭某个功能。
基础用法
绑定 v-model 到一个 Boolean 类型的变量。 可以使用 activeColor 属性与 inactiveText 属性来设置开关的背景色
开关类型
通过设置 type
属性即可改变开关的样式。type
可用值为 circle
- 圆形(默认)、line
- 线性
文字描述
使用 active-text
属性与 inactive-text
属性来设置开关的文字描述, inline-prompt
内部文字描述
自定义开关的值
通过 trueValue
和 falseValue
可以自定义开关的值
禁用状态
设置 disabled
属性,接受一个Boolean,设置true即可禁用
切换拦截
设置 before-change
函数,函数的返回值将用于判断是否阻止切换
API
Attributes
属性名 | 描述 | 类型 | 默认值 |
---|---|---|---|
v-model | 绑定值,必须等于 trueValue 或 falseValue,默认为 Boolean 类型 | boolean | string | number | - |
type | switch形状 | line | circle | circle |
disabled | 是否禁用 | boolean | false |
width | switch 的宽度 | string | number | - |
inline-prompt | 是否开启内部文字描述 | boolean | false |
active-text | 激活状态文字描述 | string | - |
inactive-text | 未激活状态文字描述 | string | - |
trueValue | 激活状态绑定的值 | boolean | string | number | - |
falseValue | 未激活状态绑定的值 | boolean | string | number | - |
active-color | 激活状态时的背景颜色 | string | - |
inactive-color | 未激活激活状态时的背景颜色 | string | - |
before-change | switch 状态改变前的钩子, 返回 false 或者返回 Promise 且被 reject 则停止切换 | () => Promise<boolean> | boolean | - |
Events
name | 描述 | 函数类型 |
---|---|---|
change | switch 状态发生变化时的回调函数 | (val) => void |
Slots
name | 描述 | scoped |
---|---|---|
inline | 自定义内部文字描述 | - |
loading | 自定义loading图标 | - |
最后更新时间: