Skip to content
目录

Switch 开关

仅用于两种状态之间进行切换,一般用于“开”/“关”。

基础用法

通过 v-model 指令,绑定并控制 switch 的状态。

自定义颜色

通过 on-coloroff-color,来分别设置 switch “开”/“关” 状态的颜色。

禁用状态

使用 disabled 属性,来禁用 switch

加载状态

使用 loading 属性,设置为加载状态。

描述内容

使用 on-textoff-text 属性,来添加描述信息,注意,它们仅能添加文字类型描述。

图标描述

使用 on-iconoff-icon 属性,来设置图标描述,所有 Violet 内置的图标您都可以使用。

内部模式(描述内容)

使用 is-inside 属性,调整描述内容为“内部模式”,如下所示。

自定义内容

使用 onoff 插槽,来自定义 on/off 状态内容。

TIP

如果单纯的文字与图标无法满足您(或是您想使用自定义图标),您可以使用这两个插槽自定义内容。

WARNING

注意:这两个插槽的优先级非常高,当您使用了这两个插槽后,属性内容都会被覆盖。并且,由于我们无法预知您会在插槽内放置什么内容,所以可能导致我们的默认样式无法达到您想要的效果,此时,需要您手动补充样式代码。

On
Off
On

调整尺寸

使用 size 属性,调整尺寸,共支持: 'small' | 'normal' | 'large',默认为 'normal'

APIs

属性

属性名说明类型默认值是必需项
v-model开关状态值boolean——true
disabled禁用状态booleanfalsefalse
loading加载状态booleanfalsefalse
is-inside是否为内部模式booleanfalsefalse
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定义 “关” 状态内容

Powered by ❤️ L1en