Toggle Group.
Related states, held together.
ToggleGroup owns selection and roving focus. Toggle owns size, emphasis, color, radius and finish. attached connects borders; it does not turn the group into a ButtonGroup. segmented draws a sunken track with a raised thumb on the pressed toggle, for compact exclusive choices.
Make it yours
Preparing the example…
Composition
AnatomyToggleGroup owns selection and roving focus. Toggle owns size, emphasis, color, radius and finish. attached connects borders; it does not turn the group into a ButtonGroup. segmented draws a sunken track with a raised thumb on the pressed toggle, for compact exclusive choices.
ToggleGroup (value, multiple, orientation)
├── Toggle value=bold
├── Toggle value=italic
└── Toggle value=underlineA 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 & statesSizes
Compare the three Dixy shirt sizes side by side.
Loading source…
Visual treatments
Emphasis changes presentation while the primitive keeps behavior.
Loading source…
Semantic colors
Semantic color supplements the selected state or measurement.
Loading source…
Corner radii
Contextual rounding applies to the control or surface; large panels stay readable.
Loading source…
Materials
Optional static finishes use the same public component. Import materials.css in your application.
Loading source…
Orientation
The owning primitive controls layout and keyboard behavior as documented above.
Loading source…
The finer details
API referenceGenerated from Dixy’s local TypeScript interfaces. Native and Base UI ToggleGroup props are forwarded; this table covers the options Dixy adds.
Toggle
| Prop | Type / description | Default |
|---|---|---|
size | "sm" | "md" | "lg"Component proportions; preserves the shared interaction target. | md |
variant | "soft" | "solid" | "outline" | "ghost"Visual emphasis; behavioral state remains primitive-owned. | soft |
color | "neutral" | "accent" | "danger" | "success"Semantic emphasis; unselected controls remain neutral. | accent |
radius | "none" | "sm" | "md" | "lg" | "full"Contextual rounding; panels cap full rounding to preserve content. | Theme.radius |
material | "matte" | "glossy" | "soft" | "metal" | "paper"Optional static finish; import materials.css. | Theme.material |
ToggleGroup
| Prop | Type / description | Default |
|---|---|---|
attached | booleanVisually connect adjacent toggles without changing single/multiple selection. | false |
segmented | booleanDraw the group as a segmented control: a sunken track with a raised surface thumb on each pressed toggle. Replaces `attached` and overrides the toggles' variant and color for the pressed state; selection, focus and keyboard behaviour are unchanged. | false |
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
AccessibilitySingle and multiple selection use the same value-array contract. Base UI handles group focus and disabled behavior. 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.
Single and multiple selection use the same value-array contract. Base UI handles group focus and disabled behavior. Component aliases reference Dixy semantic tokens; refs, events and render composition are forwarded unchanged. Visual settings follow Dixy shirt sizes, contextual radii and semantic tokens where applicable. Static finishes are optional, and reduced motion is immediate. Base UI keeps refs, state, events, keyboard and presence; this implementation pass does not establish WCAG conformance.
--dixy-primitive-gap