Switch 开关
仅用于两种状态之间进行切换,一般用于“开”/“关”。
基础用法
通过 v-model
指令,绑定并控制 switch
的状态。
自定义颜色
通过 on-color
、off-color
,来分别设置 switch
“开”/“关” 状态的颜色。
禁用状态
使用 disabled
属性,来禁用 switch
。
加载状态
使用 loading
属性,设置为加载状态。
描述内容
使用 on-text
、off-text
属性,来添加描述信息,注意,它们仅能添加文字类型描述。
关
开
图标描述
使用 on-icon
、off-icon
属性,来设置图标描述,所有 Violet 内置的图标您都可以使用。
内部模式(描述内容)
使用 is-inside
属性,调整描述内容为“内部模式”,如下所示。
开
自定义内容
使用 on
、off
插槽,来自定义 on
/off
状态内容。
TIP
如果单纯的文字与图标无法满足您(或是您想使用自定义图标),您可以使用这两个插槽自定义内容。
WARNING
注意:这两个插槽的优先级非常高,当您使用了这两个插槽后,属性内容都会被覆盖。并且,由于我们无法预知您会在插槽内放置什么内容,所以可能导致我们的默认样式无法达到您想要的效果,此时,需要您手动补充样式代码。
On
Off
On
调整尺寸
使用 size
属性,调整尺寸,共支持: 'small' | 'normal' | 'large'
,默认为 'normal'
。
APIs
属性
属性名 | 说明 | 类型 | 默认值 | 是必需项 |
---|---|---|---|---|
v-model | 开关状态值 | boolean | —— | true |
disabled | 禁用状态 | boolean | false | false |
loading | 加载状态 | boolean | false | false |
is-inside | 是否为内部模式 | boolean | false | false |
on-color | 定义“开”状态的颜色 | string | —— | false |
off-color | 定义“关”状态的颜色 | string | —— | false |
on-text | 定义“开”状态描述文字 | string | —— | false |
off-text | 定义“关”状态描述文字 | string | —— | false |
on-icon | 定义“开”状态描述图标 | string | —— | false |
off-icon | 定义“关”状态描述图标 | string | —— | false |
width | 定义宽度 | string | —— | false |
插槽
插槽名 | 说明 |
---|---|
on | 定义 “开” 状态内容 |
off | 定义 “关” 状态内容 |