Leave Yamada UI a star

Star
Yamada UIYamada UIv1.6.4

Checkbox

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

Source@yamada-ui/checkbox

Props

CheckboxIconProps

as

Description

The HTML element to render.

Type

"symbol" | "object" | "clipPath" | "filter" | "g" | "marker" | "mask" | "p" | "text" | "style" | "animate" | "svg" | "a" | "abbr" | "address" | "area" | "article" | "aside" | "audio" | ... 149 more ... | "view"

isChecked

Description

If true, the icon will be checked.

Type

boolean

Default

false

isDisabled

Description

If true, the form control will be disabled.

Type

boolean

Default

false

isIndeterminate

Description

If true, the icon will be indeterminate.

Type

boolean

Default

false

isInvalid

Description

If true, the form control will be invalid.

Type

boolean

Default

false

isReadOnly

Description

If true, the form control will be readonly.

Type

boolean

Default

false

isRequired

Description

If true, the form control will be required.

Type

boolean

Default

false

CheckboxProps

colorScheme

Description

The visual color appearance of the component.

Type

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

Default

"primary"

defaultIsChecked

Description

If true, the checkbox will be initially checked.

Type

boolean

Default

false

iconProps

Description

Props for icon component.

Type

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

id

Description

id assigned to input.

Type

string

inputProps

Description

Props for input element.

Type

InputHTMLAttributes<HTMLInputElement>

isChecked

Description

If true, the checkbox will be checked.

Type

boolean

Default

false

isDisabled

Description

If true, the form control will be disabled.

Type

boolean

Default

false

isIndeterminate

Description

If true, the checkbox will be indeterminate.

Type

boolean

Default

false

isInvalid

Description

If true, the form control will be invalid.

Type

boolean

Default

false

isReadOnly

Description

If true, the form control will be readonly.

Type

boolean

Default

false

isRequired

Description

If true, the form control will be required.

Type

boolean

Default

false

labelProps

Description

Props for label element.

Type

HTMLUIProps<"span">

name

Description

The HTML name attribute used for forms.

Type

string

onBlur

Description

The callback invoked when the checkbox is blurred.

Type

FocusEventHandler<HTMLInputElement>

onChange

Description

The callback invoked when the checked state changes.

Type

ChangeEventHandler<HTMLInputElement>

onFocus

Description

The callback invoked when the checkbox is focused.

Type

FocusEventHandler<HTMLInputElement>

selectOnEnter

Description

If true, the checkbox will be selected when the Enter key is pressed.

Type

boolean

Default

false

size

Description

The size of the Checkbox.

Type

"sm" | "md" | "lg"

Default

"md"

tabIndex

Description

The tab-index property of the underlying input element.

Type

number

value

Description

The value to be used in the checkbox input.

Type

Y

variant

Description

The variant of the Checkbox.

Type

string

UseCheckboxProps

defaultIsChecked

Description

If true, the checkbox will be initially checked.

Type

boolean

Default

false

id

Description

id assigned to input.

Type

string

isChecked

Description

If true, the checkbox will be checked.

Type

boolean

Default

false

isDisabled

Description

If true, the form control will be disabled.

Type

boolean

Default

false

isIndeterminate

Description

If true, the checkbox will be indeterminate.

Type

boolean

Default

false

isInvalid

Description

If true, the form control will be invalid.

Type

boolean

Default

false

isReadOnly

Description

If true, the form control will be readonly.

Type

boolean

Default

false

isRequired

Description

If true, the form control will be required.

Type

boolean

Default

false

name

Description

The HTML name attribute used for forms.

Type

string

onBlur

Description

The callback invoked when the checkbox is blurred.

Type

FocusEventHandler<HTMLInputElement>

onChange

Description

The callback invoked when the checked state changes.

Type

ChangeEventHandler<HTMLInputElement>

onFocus

Description

The callback invoked when the checkbox is focused.

Type

FocusEventHandler<HTMLInputElement>

selectOnEnter

Description

If true, the checkbox will be selected when the Enter key is pressed.

Type

boolean

Default

false

tabIndex

Description

The tab-index property of the underlying input element.

Type

number

value

Description

The value to be used in the checkbox input.

Type

Y

CheckboxGroupProps

align

Description

The CSS align-items property.

Type

UIValue<AlignItems>

basis

Description

The CSS flex-basis property.

Type

UIValue<number | "content" | "px" | "initial" | "inherit" | (string & {}) | "auto" | "max" | "min" | "1" | "-moz-initial" | "revert" | "revert-layer" | "unset" | "2xl" | "lg" | "md" | "sm" | ... 68 more ... | "xs">

defaultValue

Description

The initial value of the checkbox group.

Type

Y[]

direction

Description

The CSS flex-direction property.

Type

UIValue<FlexDirection>

grow

Description

The CSS flex-grow property.

Type

UIValue<FlexGrow>

isDisabled

Description

If true, the form control will be disabled.

Type

boolean

Default

false

isInvalid

Description

If true, the form control will be invalid.

Type

boolean

Default

false

isNative

Description

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

Type

boolean

Default

false

isReadOnly

Description

If true, the form control will be readonly.

Type

boolean

Default

false

isRequired

Description

If true, the form control will be required.

Type

boolean

Default

false

items

Description

If provided, generate checkboxes based on items.

Type

CheckboxItem<Y>[]

Default

'[]'

justify

Description

The CSS justify-content property.

Type

UIValue<JustifyContent>

onChange

Description

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

Type

(value: Y[]) => void

shrink

Description

The CSS flex-shrink property.

Type

UIValue<FlexShrink>

value

Description

The value of the checkbox group.

Type

Y[]

wrap

Description

The CSS flex-wrap property.

Type

UIValue<FlexWrap>

UseCheckboxGroupProps

defaultValue

Description

The initial value of the checkbox group.

Type

Y[]

isNative

Description

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

Type

boolean

Default

false

onChange

Description

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

Type

(value: Y[]) => void

value

Description

The value of the checkbox group.

Type

Y[]

Edit this page on GitHub

PreviousRadioCardNextCheckboxCard