Components/Checkbox

Checkbox

Newform

Accessible checkbox control with visible label, optional helper text, disabled state, and token-based focus styling.

import { Checkbox } from '@/components/forge'

Preview

Checkbox

Code Example

Props

PropTypeDefaultRequiredDescription
labelReact.ReactNode-NoVisible label next to the checkbox
descriptionReact.ReactNode-NoOptional helper copy below the label
checkedboolean-NoControlled checked state
defaultCheckedboolean-NoInitial checked state for uncontrolled usage
disabledbooleanfalseNoDisables interaction

Variants

defaultcheckeddisabled

Accessibility

  • Uses a native checkbox input for keyboard and screen reader support
  • Visible label is associated with the input via htmlFor
  • Focus ring is applied directly to the input

Related Components