Switch
开关。Reka UI SwitchRoot 承载勾选状态机(aria / 键盘),支持布尔与任意值绑定:true-value / false-value 自定义取值(如 'dark' / 'light'),带可选 label。
开启态的主色实底可经 color 换色:primary(缺省,跟宿主主色)/ danger / success / warning / info 或十六进制,见主题 token → 换色。
基础
布尔 / 自定义值 / 禁用
API
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
label | string | undefined | undefined | — |
labelPlacement | "end" | "start" | undefined | "end" | 文字在开关的哪一侧:`end`(缺省)在后、同勾选框;`start` 在前。按书写方向说,从右往左排版时跟着翻 |
disabled | boolean | undefined | false | — |
trueValue | string | number | boolean | undefined | true | — |
falseValue | string | number | boolean | undefined | false | — |
size | "mini" | "small" | "medium" | "large" | "super" | undefined | undefined | 尺寸:mini / small / medium(默认) / large / super;不传则跟随环境 data-size |
color | UiColor | undefined | undefined | 色块颜色:`primary`(缺省,跟宿主主色)/ `danger` / `success` / `warning` / `info`,或十六进制 `#rrggbb` |
modelValue | string | number | boolean | undefined | false | — |
Emits
| 事件 | 载荷 | 说明 |
|---|---|---|
update:modelValue | [value: string | number | boolean | undefined] | — |
Slots
| 插槽 | 说明 |
|---|---|
default | — |