Switch 开关
用于在打开和关闭状态之间进行切换。
代码演示
基础用法
通过点击按钮来控制开启和关闭状态,v-model
绑定开关的开启状态。
<hd-switch v-model="open"></hd-switch>
const open = ref<boolean>(false)
禁用状态
通过disabled
属性控制按钮是否可以点击,true
时不可点击。
<hd-switch v-model="open" :disabled="disabled"></hd-switch>
const open = ref<boolean>(false)
const disabled = ref<boolean>(true)
自定义大小
通过size
属性自定义开关的大小,单位px
,默认24。
<hd-switch v-model="open" size="30"></hd-switch>
自定义颜色
activeColor
属性表示打开时开关的背景颜色,默认值是#2979ff
;inactiveColor
属性表示关闭时开关的背景颜色,默认值是#fffffff
。
<hd-switch v-model="open" activeColor="#ee0a24" inactiveColor="#dcdee0"></hd-switch>
圆点与外边框距离
通过space
控制圆点与外边框之间的距离,默认0。
<hd-switch v-model="open" space="2"></hd-switch>
Props
Name | Description | Type | Required | Default |
---|---|---|---|---|
disabled | 是否禁用 | Boolean | false | 默认值是:false |
size | 开关尺寸,单位px | String / Number | false | 默认值是:24 |
activeColor | 打开时的背景颜色 | String | false | 默认值是:#2979ff |
inactiveColor | 关闭时的背景颜色 | String | false | 默认值是:#fffffff |
value | 通过v-model双向绑定的值 | Boolean / String / Number | false | 默认值是:false |
activeValue | 打开选择器时的值 | String / Number / Boolean | false | 默认值是:true |
inactiveValue | 关闭选择器时的值 | String / Number / Boolean | false | 默认值是:false |
asyncChange | 是否开启异步变更,开启后需要手动控制输入值 | Boolean | false | 默认值是:false |
space | 圆点与外边框的距离 | String / Number | false | 默认值是:0 |
Events
Event Name | Description | Parameters |
---|---|---|
update:modelValue | 选择器状态发生变化时触发 | value:选择器的值,建议通过v-model双向绑定输入值,而不是监听此事件的形式 |
change | 选中状态变更 | value:打开时为active-value值,关闭时为inactive-value值 |