# Switch 开关
# Switch 概述
在两种状态间切换时用到的开关选择器。
# Switch 代码演示
# 基本
基本用法,状态切换时会触发事件.
# 尺寸
设置size
为 large
或 small
,使用大号和小号的开关。
# 文字和图标
自定义内容,建议如果使用2个汉字,将开关尺寸设置为 large
。
# 不可用
禁用开关。
# 自定义大小
通过width
和height
自定义开关的宽高。
# Switch API
# Switch props
属性 | 说明 | 类型 | 默认值 |
---|---|---|---|
value | 指定当前是否选中,可以使用 v-model 双向绑定数据 | Boolean | false |
size | 开关的尺寸,可选值为 large 、small 或者不写。建议开关如果使用了2个汉字的文字,使用 large 。 | String | - |
disabled | 禁用开关 | Boolean | false |
width | 自定义宽度(不推荐添加内容) | String, Number | 48 |
height | 自定义高度(不推荐添加内容) | String, Number | 24 |
true-value | 选中时的值,当使用类似 1 和 0 来判断是否选中时会很有用 | String, Number, Boolean | true |
false-value | 没有选中时的值,当使用类似 1 和 0 来判断是否选中时会很有用 | String, Number, Boolean | false |
true-color | 自定义正确背景色(须与自定义错误背景色同时设置) | String | - |
false-color | 自定义错误背景色(须与自定义正确背景色同时设置) | String | - |
# Switch events
事件名 | 说明 | 返回值 |
---|---|---|
on-change | 开关变化时触发,返回当前的状态 | true | false |
on-focus | 开关聚焦时触发,返回当前的事件 | event |
on-blur | 开关失焦时触发,返回当前的事件 | event |
# Switch slot
名称 | 说明 |
---|---|
open | 自定义显示打开时的内容 |
close | 自定义显示关闭时的内容 |