跳到正文
GitHub

表单

Checkbox

一个在表单提交时才生效的选择。

什么时候用它

立刻生效的开关是 Switch。

示例

default

说明

一个在表单提交时才生效的选择。

支持不确定状态(checked="indeterminate"),这正是“全选”表头在只选中了部分行时需要的——那里放一个普通的未勾选框,是在告诉读者与事实相反的话。

Field 搭配使用,或者在调用处用 <label> 包住它,让旁边的文字也成为点击目标的一部分。

属性

同时接受 ComponentProps<typeof CheckboxPrimitive.Root> 里的全部属性,它们会直接透传给底层元素,不再逐条列出。

键盘操作

Checkbox keyboard interactions
按键作用
Space切换勾选状态。

无障碍

  • 支持不确定态,这正是“全选”表头在只选了一部分时需要的——普通的未勾选状态在那里表达的是相反的意思。