Skip to content

Switch 开关

开关组件,用于切换布尔值状态(开/关)。

基础用法

尺寸

禁用状态

错误状态

error 属性仅控制开关边框颜色,不渲染错误消息。

自定义标签(插槽)

API

Props

属性类型默认值说明
modelValuebooleanfalse开关状态(v-model)
labelstring''标签文字
size'sm' | 'md' | 'lg''md'尺寸
disabledbooleanfalse是否禁用
errorbooleanfalse是否显示错误状态

Slots

名称说明
default标签内容(优先级高于 label

Events

事件参数说明
update:modelValue(value: boolean)状态变化时触发
change(event: Event)原生 change 事件

注意事项

  • Switch 本质是一个特殊样式的 Checkbox,行为一致
  • error 属性仅控制边框颜色,不渲染错误消息
  • 聚焦时显示聚焦环,确保可访问性

Released under the MIT License