Checkbox

Multi-select control with indeterminate state and a managed group.

Import#

import { Checkbox } from "astralis-ui";
// Checkbox.Group

Group#

Checkbox.Group manages the array for you — give each checkbox a value and read onChange(string[]).

Selected: react

Sizes, colors and states#

indeterminate shows the dash — the classic "some children selected" signal for select-all rows.

Props#

PropTypeDefaultDescription
checked / defaultChecked / onChangeboolean / boolean / (e) => void— / false / —Controlled / uncontrolled API.
valuestringIdentifies the checkbox inside a Group.
size"sm" | "md" | "lg""md"Box size.
colorSchemeall 11 schemes"brand"Checked hue.
indeterminatebooleanfalseDash instead of check.
invalid / disabled / readOnlybooleanfalseState flags — inherited from Field.

Checkbox.Group#

PropTypeDefaultDescription
value / defaultValue / onChangestring[] / string[] / (values: string[]) => void— / [] / —The selected values.
orientation"horizontal" | "vertical""vertical"Layout.
colorScheme / disabledShared defaults for every child.

Keyboard#

KeyAction
TabMove between checkboxes — each is its own tab stop
SpaceToggle the focused checkbox

Accessibility#

A real <input type="checkbox"> lives under the styled box, so keyboard, form submission and screen-reader behavior all come natively.