Switch 开关
在两种互斥状态之间切换。
基础用法
v-model 绑定布尔值。开/关背景色由 CSS 变量 --u-switch-on-color、--u-switch-off-color 控制。
尺寸
Open
Open
Open
文字描述
使用 active-text、inactive-text 显示状态文案;inline-prompt 控制文字是否显示在滑块内侧(仅首字符)。
配置 active-text 与 inactive-text。
Pay by month
Pay by month
是
Y
超出省略
完整展示多个内容
自定义图标
TIP
使用 active-icon、inactive-icon 设置图标:可传入已注册的组件名字符串,或直接传入 SVG Vue 组件。图标库见 图标。
配置 active-icon 与 inactive-icon;inline-prompt 控制图标是否显示在滑块内侧。
扩展取值类型
通过 active-value、inactive-value 自定义开/关对应值,可为 Boolean、String 或 Number。
禁用
设置 disabled 禁用开关。
加载中
loading 为 true 时显示加载状态。
阻止切换
设置 before-change:返回 false 或返回的 Promise 被拒绝时,将阻止状态切换。
自定义操作图标
使用 active-action-icon、inactive-action-icon。
自定义操作插槽
使用 active-action、inactive-action 插槽自定义操作区。
T
开关 API
开关 属性
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值,应与 active-value 或 inactive-value 之一相等,默认布尔类型 | boolean / string / number | false |
| disabled | 是否禁用 | boolean | false |
| loading | 是否加载中 | boolean | false |
| size | 尺寸 | enum | '' |
| width | 宽度 | number / string | '' |
| inline-prompt | 图标或文字是否显示在滑块内;为文字时仅渲染首字符 | boolean | false |
| active-icon | 打开状态图标,优先级高于 active-text | string / Component | — |
| inactive-icon | 关闭状态图标,优先级高于 inactive-text | string / Component | — |
| active-action-icon | 打开状态操作区图标 | string / Component | — |
| inactive-action-icon | 关闭状态操作区图标 | string / Component | — |
| active-text | 打开状态文案 | string | '' |
| inactive-text | 关闭状态文案 | string | '' |
| active-value | 打开状态绑定值 | boolean / string / number | true |
| inactive-value | 关闭状态绑定值 | boolean / string / number | false |
| name | 原生 name | string | '' |
| validate-event | 是否触发表单校验 | boolean | true |
| before-change | 切换前钩子;返回 false 或 Promise 被拒绝则阻止切换 | Function | — |
| id | 原生 id | string | — |
| tabindex | 原生 tabindex | string / number | — |
| aria-label a11y | 同原生 aria-label | string | — |
开关 事件
| 事件名 | 说明 | 类型 |
|---|---|---|
| change | 绑定值变化时触发 | Function |
开关 插槽
| 名称 | 说明 |
|---|---|
| active-action | 自定义打开侧操作区 |
| inactive-action | 自定义关闭侧操作区 |
| active | 自定义打开态内容 |
| inactive | 自定义关闭态内容 |
开关 方法
| 名称 | 说明 | 类型 |
|---|---|---|
| focus | 使开关获得焦点 | Function |