Switch 开关
表示两种相互对立的状态间的切换,多用于触发「开/关」。
演示
基础用法
绑定 v-model 到一个 boolean 类型的变量。可以使用 true 和 false 分别表示开和关。
文字描述
使用 checked-text 和 unchecked-text 属性来设置开关的文字描述。
自定义操作图标
使用 action 插槽, 配合 props-checked 作用域来自定义渲染操作图标。
API
Switch Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
v-model | 开关状态(是否打开) | boolean | false |
checked-text | 开启时的文字描述 | string | - |
unchecked-text | 关闭时的文字描述 | string | - |
Switch Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
change | 开关状态改变时触发 | (checked: boolean) |
Switch CSS Variables
| 变量名 | 默认值 | 描述 |
|---|---|---|
--l-switch-height | 20px | 开关按钮高度 |
--l-switch-width | var(--l-switch-height) * 2 | 开关按钮宽度 |
Switch Slots
| 名称 | 描述 | 插槽参数 |
|---|---|---|
action | 开关操作按钮内容 | { checked: boolean } |