Skip to content

Checkbox ​

Checkbox is a choice among several, or a confirmation.

When to use ​

Use it for options that are chosen together and saved with a form, and for the selection of the items of a list or the rows of a table. indeterminate shows that some of them are selected. A setting that takes effect at once is a Toggle.

Props ​

PropDefaultDescription
checkedfalseThe state (bindable)
indeterminatefalseSome of a list is selected
labelThe text beside the box
ariaLabelThe accessible name when there is no text
disabledfalseCannot be changed
idThe id of the input
onchangeCalled with the new state

Contract ​

The control is as high as a small button, and the whole of it is pressed, text included. The box is a native checkbox, the square of an icon with one line; checked, it takes the solid surface and a check mark; indeterminate, the stronger raise surface without a mark. The text is gap-sm from the box, one line, trimmed to its ink. Disabled, the text and an empty or partial box are dimmed; a checked box takes the solid-disabled surface with its text for the mark, not dimmed.

Example ​

Checkbox

Released under the Apache-2.0 license.