Skip to content

Switch 开关

二态切换控件,thumb 在 spring 曲线下滑动,按下时轻微拉伸,模拟物理质感。

基础用法

vue
<ASwitch v-model="value" />

尺寸

vue
<ASwitch v-model="value" size="sm" />
<ASwitch v-model="value" size="md" />

加载态 / 禁用

vue
<ASwitch v-model="value" loading />
<ASwitch v-model="value" disabled />

API

Props

名称类型默认值说明
modelValuebooleanfalse开关状态
size'sm' | 'md''md'尺寸
disabledbooleanfalse禁用
loadingbooleanfalse加载中,显示 spinner

Emits

名称参数说明
update:modelValueboolean状态切换

无障碍

  • 使用原生 <button role="switch"> 实现,aria-checked 反映状态
  • 支持 Space / Enter 键切换
  • 焦点环遵循全局 :focus-visible 样式

MIT License