Appearance
Switch 开关
表示两种相互对立的状态间的切换,多用于触发「开/关」。
基础用法
绑定 v-model 到一个 Boolean 类型的变量。 active-color 与 inactive-color 属性来设置开关的背景色。
尺寸
提供 large、default 和 small 三种尺寸。
文字描述
使用 active-text 属性与 inactive-text 属性来设置开关的文字描述。 使用 inline-prompt 属性来使文字显示在开关内部。
扩展的 value 类型
你可以设置 active-value 和 inactive-value 属性,它们接受 Boolean、String 或 Number 类型的数据。
禁用状态
设置 disabled 属性,接受一个 Boolean,设置 true 即可禁用。
加载状态
设置 loading 属性,接受一个 Boolean,设置 true 即加载中状态。
阻止切换
设置 before-change 属性,若返回 false 或者返回 Promise 且被 reject,则停止切换。
API
Attributes
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| v-model / model-value | 绑定值 | boolean / string / number | false |
| disabled | 是否禁用 | boolean | false |
| loading | 是否处于加载中状态 | boolean | false |
| size | 开关的尺寸 | string | default |
| width | 开关的宽度(像素) | string / number | — |
| active-icon | switch 打开时所显示图标的组件名,设置此项会忽略 active-text | string | — |
| inactive-icon | switch 关闭时所显示图标的组件名,设置此项会忽略 inactive-text | string | — |
| active-text | switch 打开时的文字描述 | string | — |
| inactive-text | switch 关闭时的文字描述 | string | — |
| active-value | switch 打开时的值 | boolean / string / number | true |
| inactive-value | switch 关闭时的值 | boolean / string / number | false |
| active-color | switch 打开时的背景色 | string | — |
| inactive-color | switch 关闭时的背景色 | string | — |
| name | switch 对应的 name 属性 | string | — |
| validate-event | 改变 switch 状态时是否触发表单的校验 | boolean | true |
| before-change | switch 状态改变前的钩子, 返回 false 或者返回 Promise 且被 reject 则停止切换 | function | — |
| inline-prompt | 无论图标或文本是否显示在开关内部 | boolean | false |
Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| change | switch 状态发生变化时的回调函数 | val: 新状态的值 |
| input | switch 状态发生变化时的回调函数 | val: 新状态的值 |