表单
Checkbox
一个在表单提交时才生效的选择。
什么时候用它
立刻生效的开关是 Switch。
示例
default
说明
一个在表单提交时才生效的选择。
支持不确定状态(checked="indeterminate"),这正是“全选”表头在只选中了部分行时需要的——那里放一个普通的未勾选框,是在告诉读者与事实相反的话。
和 Field 搭配使用,或者在调用处用 <label> 包住它,让旁边的文字也成为点击目标的一部分。
属性
同时接受 ComponentProps<typeof CheckboxPrimitive.Root> 里的全部属性,它们会直接透传给底层元素,不再逐条列出。
键盘操作
| 按键 | 作用 |
|---|---|
| Space | 切换勾选状态。 |
无障碍
- 支持不确定态,这正是“全选”表头在只选了一部分时需要的——普通的未勾选状态在那里表达的是相反的意思。