# Switch 选择器
表示两种相互对立的状态间的切换,多用于触发「开/关」。
# 基础用法
TIP
绑定v-model到一个Boolean类型的变量。可以使用active-color属性与inactive-color属性来设置开关的背景色。
<ay-switch v-model="value" active-color="#13ce66" inactive-color="#ff4949"></ay-switch>
# 文字开关
TIP
使用active-text属性与inactive-text属性来设置开关的文字描述。
<ay-switch v-model="value" active-color="#13ce66" active-text="按天计费" inactive-text="按月计费"></ay-switch>
<script>
export default {
name:'switch-demo-base',
data(){
return{
value:true
}
}
}
</script>
# 扩展value类型
TIP
设置active-value和inactive-value属性,接受Boolean, String或Number类型的值。
<ay-switch
v-model="value"
active-color="#13ce66"
active-value="100"
inactive-value="0"
></ay-switch>
# 禁用
TIP
设置disabled属性,接受一个Boolean,设置true即可禁用。
<ay-switch v-model="value" active-color="#13ce66" disabled></ay-switch>
# Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
value / v-model | 绑定值 | boolean / string / number | — | — |
disabled | 是否禁用 | boolean | — | false |
width | switch 的宽度(像素) | number | — | 40 |
active-icon-class | switch 打开时所显示图标的类名,设置此项会忽略 active-text | string | — | — |
inactive-icon-class | 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 | — | #409EFF |
inactive-color | switch 关闭时的背景色 | string | — | #C0CCDA |
name | switch 对应的 name 属性 | string | — | — |
validate-event | 改变 switch 状态时是否触发表单的校验 | boolean | - | true |
# Events
事件名称 | 说明 | 回调参数 |
---|---|---|
change | switch 状态发生变化时的回调函数 | 新状态的值 |
# Methods
方法名 | 说明 | 参数 |
---|---|---|
focus | 使 Switch 获取焦点 | - |