Toggle Sidebar B
AppearanceLight & dark mode D

Checkbox

Binary input. Supports checked, unchecked, and indeterminate states via modelValue.

Basic

A checkbox paired with a Label so the text is a click target too.

Replay preview

With description

Wrap the label and a FieldDescription in FieldContent for a helper line.

Replay preview

Your Desktop and Documents folders are kept in sync across every device you sign in on.

Disabled

Use the disabled prop to disable the checkbox.

Replay preview

Invalid

Set aria-invalid on the Checkbox and pair it with a FieldError for validation.

Replay preview

Group

Stack several checkboxes in a FieldSet, each bound to its own ref.

Replay preview
Sidebar

Choose which sections appear in the navigation sidebar.

Select all

A header checkbox goes indeterminate when only some rows are selected.

Replay preview
NameRole
Olivia MartinOwner
Jackson LeeMember
Isabella NguyenMember
William KimViewer

API Reference

Checkbox

PropTypeDefaultDescription
modelValueboolean | 'indeterminate'Checked state. Supports v-model.
defaultValueboolean | 'indeterminate'falseInitial state when v-model is not used.
disabledbooleanfalseDisable input.
idstringMatch with Label for prop.
EventDescription
update:modelValueFires with the new checked state. Enables v-model.

Accessibility

Keyboard shortcuts and ARIA behavior.

Shortcut Description
SpaceToggles the checkbox when focused.
TabMoves focus to or from the checkbox.
  • Uses role=checkbox with aria-checked reflecting the state.
  • Supports an indeterminate (mixed) state via aria-checked="mixed".
  • Pair with a label so the control's purpose is announced.