切换
一个有两种状态的按钮,可以是开启或关闭。
特性
- 完整的键盘导航。
- 可受控或不受控。
安装
从命令行安装此组件。
sh
$ npm add reka-ui结构
导入组件。
vue
<script setup>
import { Toggle } from 'reka-ui'
</script>
<template>
<Toggle />
</template>API 参考
根
切换组件。
| 属性 | 默认 | 类型 |
|---|---|---|
as | 'button' | AsTag | 组件此组件应渲染为的元素或组件。可通过 |
asChild | 布尔值更改默认渲染元素为作为子项传递的元素,合并它们的属性和行为。 阅读我们的 组合指南了解更多详情。 | |
defaultValue | 布尔值切换组件初始渲染时的按下状态。当您不需要控制其开启状态时使用。 | |
disabled | false | 布尔值当为 |
modelValue | boolean | null切换组件的受控按下状态。可以绑定为 | |
name | string字段的名称。随其所属的表单一起作为名称/值对提交。 | |
required | 布尔值当为 |
| 事件触发 | 载荷 |
|---|---|
update:modelValue | [value: boolean]当切换组件的值改变时调用的事件处理程序。 |
| 插槽(默认) | 载荷 |
|---|---|
modelValue | 布尔值当前值 |
state | 'on' | 'off'当前状态 |
pressed | 布尔值当前按下状态 |
disabled | 布尔值当前禁用状态 |
| 数据属性 | 值 |
|---|---|
[data-state] | "on" | "off" |
[data-disabled] | 禁用时存在 |
无障碍性
键盘交互
| 键 | 描述 |
|---|---|
空格键 | 激活/取消激活切换组件。 |
回车键 | 激活/取消激活切换组件。 |
