Switch 开关
开关控件,用于表示两种相互对立的状态间的切换,如开/关、显示/隐藏。
参数
Props
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| modelValue | boolean | - | 开关状态,true 为开,false 为关 |
| disabled | boolean | false | 是否禁用 |
| size | ComponentSize | 'medium' | 开关大小 |
| type | ComponentType | 'default' | 开关类型 |
| activeColor | string | - | 开关打开时的颜色 |
| inactiveColor | string | - | 开关关闭时的颜色 |
| activeText | string | - | 开关打开时的文字说明 |
| inactiveText | string | - | 开关关闭时的文字说明 |
| activeIcon | string | - | 开关打开时的图标 |
| inactiveIcon | string | - | 开关关闭时的图标 |
Slots
| 名称 | 描述 | 参数 |
|---|---|---|
| activeIcon | 开关打开时的自定义图标 | - |
| inactiveIcon | 开关关闭时的自定义图标 | - |
Events
| 名称 | 描述 | 参数 |
|---|---|---|
| update:modelValue | 开关状态变化时触发 | (value: boolean) => void |
| change | 开关状态变化时触发 | (value: boolean) => void |
示例
基础用法
不同尺寸
不同类型
禁用状态
自定义颜色
文字描述
图标
TypeScript
ts
// 基础颜色类型
export type ComponentType =
| "default"
| "primary"
| "secondary"
| "success"
| "warning"
| "error"
| "info";
// 组件尺寸
export type ComponentSize = "small" | "medium" | "large";