跳到正文

Switch 开关 ​

开关选择器,用于在两个互斥状态(开 / 关)之间切换,支持双尺寸与禁用状态。

使用方式 ​

组件以 EmSwitch 为名导出,全局注册后可直接使用:

vue
<template>
  <em-switch v-model="enabled" />
</template>

<script setup>
import { ref } from 'vue'

const enabled = ref(true)
</script>

尺寸 ​

状态 ​

事件 ​

使用建议 ​

✅ Do❌ Don't
用于即时生效的设置项(如消息免打扰、已读回执)用于需要提交确认才生效的表单字段
配合文字标签说明开关控制的含义单独放置开关让用户猜测用途
空间有限时使用 size="small"在同一列表中混用两种尺寸

API ​

Switch API ​

Props ​

属性类型默认值说明
modelValuebooleanfalse开关状态(v-model)/ Switch state, used with v-model
size'medium' | 'small''medium'尺寸:medium(默认)/ small / Size: medium (default) or small
disabledbooleanfalse是否禁用;禁用时不可点击且不触发事件 / Disabled: not clickable and no events fired
loadingbooleanfalse是否加载中;显示手柄内转圈并禁止点击(行为同 disabled,但不套用禁用样式)/ Loading: spinner inside handle, clicks blocked (visual style unchanged)

Events ​

事件名参数说明
update:modelValuevalue: boolean状态变化时同步 v-model / Fired on toggle to sync v-model
changevalue: boolean状态变化后的业务回调,负载为切换后的新值 / Fired after toggle with the new value