Skip to content
双端兼容 · 桌面 + 移动

Switch 开关

EwSwitch 表达二元状态(开/关),用于设置项、演示面板与筛选条件。滑块带平滑位移动效, 开启态着主色;提供三种尺寸与禁用态。不绑定 v-model 时组件自持状态(default-value 定初值), 复制标签即可交互。

基础用法

设置项中的开关
与文字标签组合时建议用 label 包裹,扩大可点击区域;change 事件实时回显。
同步:开 · 主页:关
vue
<script setup>
import { ref } from 'vue'
const sync = ref(true)
</script>

<template>
  <label style="display:inline-flex; align-items:center; gap:8px;">
    <EwSwitch v-model="sync" @change="onChange" /> 自动同步
  </label>
</template>

尺寸与禁用

small / default / large / disabled
各开关均可点击(禁用态除外),独立自持状态。
vue
<EwSwitch size="small" :default-value="true" />
<EwSwitch v-model="a" />
<EwSwitch size="large" v-model="b" />
<EwSwitch disabled v-model="c" />

API

Props

属性说明类型默认值
v-model状态booleanfalse
default-value非受控模式的初始状态(未绑定 v-model 时生效)booleanfalse
disabled禁用booleanfalse
size尺寸'small' | 'default' | 'large''default'

事件

事件说明参数
update:modelValue切换时派发boolean
change切换时派发boolean

基于 MIT 许可证发布