Checkbox

选择一个或多个独立选项，支持选中、未选中和部分选中状态，适合表单与批量选择。

我们正在让 SnowUI 组件成为 AI 对话中可直接操作的界面。目前对话交互能力仍在建设中；本页展示网站用法，支持的对话平台与组件版本将在验证后公布。 AI 对话内生成和使用 SnowUI 界面完全免费，不属于项目，不占项目或开发者席位额度，无需 SnowUI 注册、激活或付费证明。

如何使用

用于独立开关或多项选择。互斥单选用 Radio，立即生效的二态设置用 Switch；DataTable 选择列优先使用其内置选择协议。

import { Checkbox } from '@snowui-design-system/components';

属性	类型	默认值	示例	描述
`checked`	`boolean`	`false`	`checked`	选中状态（双向绑定）
`group`	`any[]`	`—`	`group={group}`	多选值数组，配合 value 双向绑定
`value`	`any`	`—`	`value={value}`	表单值
`size`	`ResourceSize \| number`	`—`	`size={42}`	组件尺寸（像素，梯度与 Icon 一致：12/16/20/24/28/32/40/48/80）
`disabled`	`boolean`	`false`	`disabled`	禁用状态
`indeterminate`	`boolean`	`false`	`indeterminate`	不确定状态（双向绑定）
`onCheckedChange`	`(checked: boolean) => void`	`—`	`onCheckedChange={(value) => { /* handle value */ }}`	原生复选状态变化后的回调
`ariaLabel`	`string`	`—`	`ariaLabel="Example"`	无可见 label 时的无障碍名称
`children`	`Snippet`	`—`	`<Checkbox>Content</Checkbox>`	标签内容
`singleLine`	`boolean`	`true`	`singleLine`	默认标签与控件保持单行，附件不压缩；窄宽时原始标签可省略显示并保留完整可访问名称，不复制 children。复杂多行内容可显式设为 false，由该内容拥有布局。需要全文提示时组合 Text lines={1}。
`gap`	`number`	`—`	`gap={42}`	继承 Frame 的间距 Token 序号；省略时使用原组件间距，显式值覆盖组件间距。有效间距至少 4 CSS px，包含零值、根字号及 gap-scale 缩放；较大首选值保留。
`enableResponsive`	`boolean`	`false`	`enableResponsive`	启用响应式
`enableContext`	`boolean`	`false`	`enableContext`	启用上下文