Checkbox

Checkbox is a component used for allowing users to select multiple values from multiple options.

Props

CheckboxProps

Description

The visual color appearance of the component.

Type

"whiteAlpha" | "blackAlpha" | "gray" | "neutral" | "red" | "danger" | "rose" | "pink" | "flashy" | "orange" | "warning" | "amber" | "yellow" | "lime" | "green" | "success" | "emerald" | "teal" | "cyan" | "sky" | "blue" | "primary" | "info" | "link" | "indigo" | "violet" | "secondary" | "purple" | "fuchsia"

Default

primary

Description

If true, the checkbox will be initially checked.

Type

boolean

Default

false

Description

Props for icon component.

Type

Omit<HTMLUIProps<"span">, "children"> & {
children: ReactElement<any, string | JSXElementConstructor<any>>
}

Description

id assigned to input.

Type

string

Description

Props for input element.

Type

InputHTMLAttributes<HTMLInputElement>

Description

If true, the checkbox will be checked.

Type

boolean

Default

false

Description

If true, the form control will be disabled.

Type

boolean

Default

false

Description

If true, the checkbox will be indeterminate.

Type

boolean

Default

false

Description

If true, the form control will be invalid.

Type

boolean

Default

false

Description

If true, the form control will be readonly.

Type

boolean

Default

false

Description

If true, the form control will be required.

Type

boolean

Default

false

Description

Props for label element.

Type

HTMLUIProps<"span">

Description

The HTML name attribute used for forms.

Type

string

Description

The callback invoked when the checkbox is blurred.

Type

FocusEventHandler<HTMLInputElement>

Description

The callback invoked when the checked state changes.

Type

ChangeEventHandler<HTMLInputElement>

Description

The callback invoked when the checkbox is focused.

Type

FocusEventHandler<HTMLInputElement>

Description

The size of the Checkbox.

Type

"sm" | "md" | "lg"

Default

md

Description

The tab-index property of the underlying input element.

Type

number

Description

The value to be used in the checkbox input.

Type

Y

Description

The variant of the Checkbox.

Type

string

CheckboxIconProps

Description

If true, the icon will be checked.

Type

boolean

Default

false

Description

If true, the form control will be disabled.

Type

boolean

Default

false

Description

If true, the icon will be indeterminate.

Type

boolean

Default

false

Description

If true, the form control will be invalid.

Type

boolean

Default

false

Description

If true, the form control will be readonly.

Type

boolean

Default

false

Description

If true, the form control will be required.

Type

boolean

Default

false

UseCheckboxProps

Description

If true, the checkbox will be initially checked.

Type

boolean

Default

false

Description

id assigned to input.

Type

string

Description

If true, the checkbox will be checked.

Type

boolean

Default

false

Description

If true, the form control will be disabled.

Type

boolean

Default

false

Description

If true, the checkbox will be indeterminate.

Type

boolean

Default

false

Description

If true, the form control will be invalid.

Type

boolean

Default

false

Description

If true, the form control will be readonly.

Type

boolean

Default

false

Description

If true, the form control will be required.

Type

boolean

Default

false

Description

The HTML name attribute used for forms.

Type

string

Description

The callback invoked when the checkbox is blurred.

Type

FocusEventHandler<HTMLInputElement>

Description

The callback invoked when the checked state changes.

Type

ChangeEventHandler<HTMLInputElement>

Description

The callback invoked when the checkbox is focused.

Type

FocusEventHandler<HTMLInputElement>

Description

The tab-index property of the underlying input element.

Type

number

Description

The value to be used in the checkbox input.

Type

Y

CheckboxGroupProps

Description

The CSS align-items property.

Type

(string & {}) | "center" | "end" | "initial" | "inherit" | "-moz-initial" | "revert" | "revert-layer" | "unset" | "normal" | "start" | "baseline" | "stretch" | "flex-end" | "flex-start" | ... 6 more ... | ((theme: StyledTheme) => UIValue<...>)

Description

The CSS flex-basis property.

Type

number | (string & {}) | "content" | "px" | "max" | "min" | "initial" | "inherit" | "auto" | "-moz-initial" | "revert" | "revert-layer" | "unset" | "sm" | "md" | "lg" | "xl" | "2xl" | ... 72 more ... | ((theme: StyledTheme) => UIValue<...>)

Description

The CSS flex-direction property.

Type

"initial" | "inherit" | "row" | "-moz-initial" | "revert" | "revert-layer" | "unset" | "column" | "column-reverse" | "row-reverse" | Partial<Record<(string & {}) | "base" | "sm" | "md" | "lg" | "xl" | "2xl", FlexDirection>> | ColorModeArray<...> | Partial<...> | ColorModeArray<...> | ((theme: StyledTheme) => UIValue...

Description

The CSS flex-grow property.

Type

(string & {}) | "initial" | "inherit" | "-moz-initial" | "revert" | "revert-layer" | "unset" | (number & {}) | Partial<Record<(string & {}) | "base" | "sm" | "md" | "lg" | "xl" | "2xl", FlexGrow>> | ColorModeArray<...> | Partial<...> | ColorModeArray<...> | ((theme: StyledTheme) => UIValue<...>)

Description

If true, the form control will be disabled.

Type

boolean

Default

false

Description

If true, the form control will be invalid.

Type

boolean

Default

false

Description

If true, input elements will receive checked attribute instead of isChecked. This assumes, you're using native radio inputs.

Type

boolean

Default

false

Description

If true, the form control will be readonly.

Type

boolean

Default

false

Description

If true, the form control will be required.

Type

boolean

Default

false

Description

If provided, generate checkboxes based on items.

Type

CheckboxItem<Y>[]

Default

'[]'

Description

The CSS justify-content property.

Type

(string & {}) | "left" | "right" | "center" | "end" | "initial" | "inherit" | "-moz-initial" | "revert" | "revert-layer" | "unset" | "normal" | "start" | "space-around" | "space-between" | ... 8 more ... | ((theme: StyledTheme) => UIValue<...>)

Description

The callback fired when any children checkbox is checked or unchecked.

Type

(value: Y[]) => void

Description

The CSS flex-shrink property.

Type

(string & {}) | "initial" | "inherit" | "-moz-initial" | "revert" | "revert-layer" | "unset" | (number & {}) | Partial<Record<(string & {}) | "base" | "sm" | "md" | "lg" | "xl" | "2xl", FlexShrink>> | ColorModeArray<...> | Partial<...> | ColorModeArray<...> | ((theme: StyledTheme) => UIValue<...>)

Description

The value of the checkbox group.

Type

Y[]

Description

The CSS flex-wrap property.

Type

"initial" | "inherit" | "-moz-initial" | "revert" | "revert-layer" | "unset" | "wrap" | "nowrap" | "wrap-reverse" | Partial<Record<(string & {}) | "base" | "sm" | "md" | "lg" | "xl" | "2xl", FlexWrap>> | ColorModeArray<...> | Partial<...> | ColorModeArray<...> | ((theme: StyledTheme) => UIValue<...>)

UseCheckboxGroupProps

Description

The initial value of the checkbox group.

Type

Y[]

Description

If true, input elements will receive checked attribute instead of isChecked. This assumes, you're using native radio inputs.

Type

boolean

Default

false

Description

The callback fired when any children checkbox is checked or unchecked.

Type

(value: Y[]) => void

Description

The value of the checkbox group.

Type

Y[]

Edit this page on GitHub

PreviousRadio NextSwitch