Skip to content

Switch 开关

基础用法

使用v-model设置开关绑定值。否则开关不会响应点击事件。

开关祈祷中...

使用 disabledloading阻止开关状态切换。

不同的类型

使用 type指定开关的类型.

不同的尺寸

使用 size指定开关大小。

文字描述

使用 activeTextinactiveText 指定开关的文字描述。

此外你还可以通过 text-status指定文字的文字.

TIP

开关默认没有设置宽度, 因此在状态切换时大小可以会发生变化, 只需手动自动宽度即可。另外,开关的文字描述在超过开关大小时会触发省略。

附带图标

你可以设置开关处于两种状态时的图标, 额外的,loading状态的图标也可以自定义

代理切换

有时候在进行开关状态切换时,需要进行一些确认.使用 before-change可以达到这样的效果

Switch API

Switch Props

属性名说明可选值默认值
modelValue开关的绑定值Boolean---
size开关的大小'small' | 'normal' | 'large'normal
type开关的类型'success' | 'info' | 'warning' | 'danger' | 'cyan'---
textStatus开关的文字描述所处位置'isnide' | 'outside'outside
inactiveText开关的失活状态的文字描述String---
activeText开关的活跃状态的文字描述String---
inactiveIcon开关的失活状态的图标String---
activeIcon开关的活跃状态的图标String---
triggerIcon开关的触发器的图标String---
color开关的颜色String---
disabled是否禁用开关Booleanfalse
loading开关是否处于加载中Booleanfalse
beforeChange开关状态切换时的代理函数, 若设置此项,需要手动调用done函数完成切换(done: () => void) => void---

Switch Events

事件名说明类型
change开关状态切换时触发的事件(status:'off' | 'on') => void

源代码

组件

贡献者

Released under the MIT License.