Checkbox Group.
Independent choices, one coherent group.
CheckboxGroup coordinates a collection of values. Name the group separately from each checkbox and preserve native form serialization.
Make it yours
Preparing the example…
Composition
AnatomyCheckboxGroup owns an array of selected values. Individual Checkbox roots own their own visuals. Use Fieldset.Legend or an accessible group name; orientation and gap affect layout only.
Fieldset.Root → Fieldset.Legend + CheckboxGroup
└── label → Checkbox.Root + Checkbox.IndicatorA place to start
UsageImport the stylesheet once at your application root. This complete example reflects the properties selected above.
Loading example…
Details that make a difference
Examples & statesOrientation
The owning primitive controls layout and keyboard behavior as documented above.
Loading source…
Field spacing
Spacing changes independently of validation and field semantics.
Loading source…
The finer details
API referenceGenerated from Dixy’s local TypeScript interfaces. Native and Base UI CheckboxGroup props are forwarded; this table covers the options Dixy adds.
CheckboxGroup
| Prop | Type / description | Default |
|---|---|---|
orientation | "horizontal" | "vertical"Arrange labeled choices. | vertical |
gap | "sm" | "md" | "lg"Spacing between choices. | md |
Built from the same foundations
Styling tokensChange Theme settings above to compare appearance, accent, neutral, radius, spacing density, motion and direction. Override component aliases on a Theme root so custom properties follow portaled content too. The wrapper merges className, style, refs and render composition with its owning primitive.
| Token | Purpose |
|---|---|
--dixy-primitive-gap | The component-specific starting point. |
--dixy-font-label-md | Control label font and line height; body roles remain readable in text inputs. |
--dixy-color-background-selected | Selected surfaces use semantic color across appearances. |
--dixy-color-border-focus | Focus indication remains visible independently of shadows. |
--dixy-spacing-inset-sm | Density-aware component padding. |
--dixy-motion-transition-feedback | Short state feedback, reduced by the inherited motion setting. |
Consider everyone
AccessibilityCheckboxGroup coordinates a collection of values. Name the group separately from each checkbox and preserve native form serialization. Provide meaningful names and verify the complete interaction with a keyboard. Color alone must not communicate state.
Target: WCAG 2.2 AA. Automated tests cover selected behavior; manual screen-reader, contrast, and zoom validation remain part of the release checklist.
Build it. Then understand it.
CheckboxGroup coordinates a collection of values. Name the group separately from each checkbox and preserve native form serialization. Component aliases reference Dixy semantic tokens; refs, events and render composition are forwarded unchanged.
--dixy-primitive-gap