开关 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图标 | - |
最后更新时间: