Skip to content

开关组件

开关组件

开关组件用于表示两种相互对立的状态,用户可以通过点击来切换状态。

基础用法

基础的开关用法,通过v-model绑定开关的值。

当前状态: 开启
显示代码箭头
复制GitHub

禁用状态

设置disabled属性可以禁用开关。

禁用开启状态:
禁用关闭状态:
显示代码箭头
复制GitHub

加载状态

设置loading属性可以显示加载状态。

加载中开启状态:
加载中关闭状态:
显示代码箭头
复制GitHub

不同样式

设置radius属性可以改变开关的样式,支持default(圆形)和square(方形)。

默认圆形样式:
方形样式:
显示代码箭头
复制GitHub

自定义颜色

通过onBgColoroffBgColor属性可以自定义开关的背景颜色。

自定义开启颜色:
自定义关闭颜色:
同时自定义开启和关闭颜色:
显示代码箭头
复制GitHub

不同尺寸

开关支持三种尺寸:small、default 和 large。

小尺寸:
默认尺寸:
大尺寸:
显示代码箭头
复制GitHub

自定义内容

使用onContentoffContent插槽可以自定义开关的内容。

显示代码箭头
复制GitHub

事件处理

开关提供了change事件,在状态改变时触发。

监听change事件:
事件日志:
当前值:关闭
显示代码箭头
复制GitHub

开关 API

属性

属性名说明类型可选值默认值
v-model绑定值boolean
size尺寸stringsmall / default / largedefault
disabled是否禁用booleanfalse
loading是否为加载状态booleanfalse
radius按钮圆角类型stringdefault / squaredefault
onBgColor开启状态的背景颜色string
offBgColor关闭状态的背景颜色string

事件

事件名说明回调参数
change状态改变时触发(value: boolean)

插槽

插槽名说明
onContent开启状态内容
offContent关闭状态内容

样式变量

开关组件使用了以下样式变量,可通过 SCSS 变量进行自定义:

变量名说明
$theme-color-primary主题色-主要
$theme-color-danger主题色-危险
$color-white白色
$color-black黑色
$bg-color-default默认背景颜色
$opacity-disabled禁用状态透明度
$font-size-small小号字体大小
$font-size-default默认字体大小
$font-size-large大号字体大小

基于MIT许可发布