切换
一个有两种状态的按钮,可以是开启或关闭。
特性
- 完整的键盘导航。
- 可受控或不受控。
安装
从命令行安装此组件。
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] | 禁用时存在 |
无障碍性
键盘交互
键 | 描述 |
---|---|
空格键 | 激活/取消激活切换组件。 |
回车键 | 激活/取消激活切换组件。 |