Skip to content

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-