Skip to content

Switch 开关 ​

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

何时使用:需要切换一个开/关状态时使用。与 Checkbox 功能类似,但视觉上更适合设置页面。

基础用法 ​

尺寸 ​

禁用状态 ​

错误状态 ​

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

自定义标签(插槽) ​

API ​

Props ​

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

Slots ​

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

Events ​

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

注意事项 ​

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

Released under the MIT License