Checkbox 复选框
用于从一个集合中选择一个或多个项目。
变体
禁用状态
尺寸
自定义内容
组合
API
Checkbox Props
继承自
Omit<HTMLAttributes<HTMLLabelElement>, 'onChange' | 'defaultValue'>
| 属性名 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| variant | 视觉样式。 | 'solid' | 'outlined' | - |
| size | 尺寸。 | 'small' | 'medium' | 'large' | - |
| disabled | 禁用状态。 | boolean | - |
| checked | 受控勾选状态。 | boolean | - |
| defaultChecked | 默认勾选状态。 | boolean | - |
| value | 选项值。 | unknown | - |
| onChange | 勾选变化回调。 | (checked: boolean) => void | - |
Checkbox.Group Props
继承自
Omit<HTMLAttributes<HTMLDivElement>, 'defaultValue' | 'onChange'>
| 属性名 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| direction | 选项排列方向。 | 'horizontal' | 'vertical' | - |
| variant | 组内默认视觉样式。 | 'solid' | 'outlined' | - |
| size | 组内默认尺寸。 | 'small' | 'medium' | 'large' | - |
| disabled | 整组禁用状态。 | boolean | - |
| value | 受控选中值数组。 | Array<T> | - |
| defaultValue | 默认选中值数组。 | Array<T> | - |
| onChange | 选中值变化回调。 | (value: Array<T>) => void | - |
Checkbox.Indicator Props
继承自
Omit<HTMLAttributes<HTMLDivElement>, 'children'>
| 属性名 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| children | 指示器内容,可接收勾选状态。 | (checked: boolean) => ReactNode | - |
Checkbox.Label Props
继承自
Omit<HTMLAttributes<HTMLSpanElement>, 'children'>
| 属性名 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| children | 标签内容,可接收勾选状态。 | ReactNode | (checked: boolean) => ReactNode | - |