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
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| modelValue | boolean | false | 开关状态(v-model)/ Switch state, used with v-model |
| size | 'medium' | 'small' | 'medium' | 尺寸:medium(默认)/ small / Size: medium (default) or small |
| disabled | boolean | false | 是否禁用;禁用时不可点击且不触发事件 / Disabled: not clickable and no events fired |
| loading | boolean | false | 是否加载中;显示手柄内转圈并禁止点击(行为同 disabled,但不套用禁用样式)/ Loading: spinner inside handle, clicks blocked (visual style unchanged) |
Events
| 事件名 | 参数 | 说明 |
|---|---|---|
update:modelValue | value: boolean | 状态变化时同步 v-model / Fired on toggle to sync v-model |
change | value: boolean | 状态变化后的业务回调,负载为切换后的新值 / Fired after toggle with the new value |
