Button Group
premiumStyled button group for single or multi-select choices.
Overview
The Button Group displays options as styled buttons that users can click to select. Supports single-select (like radio) or multi-select (like checkbox group) modes with active state styling.
Properties
| Property | Type | Default | Description |
|---|---|---|---|
name | String | "selection" | Field name used in form data. |
label | String | "Choose" | Label displayed above the button group. |
options | Array | -- | List of options with label and value. |
selectionType | Enum | "single" | "single" (one selection) or "multiple" (multiple selections). |
required | Boolean | false | Whether a selection must be made. |
Features
- Single or multi-select modes
- Active/inactive button styling (background, text color, border)
- Configurable gap and layout
- Toggle-deselect behavior
Tips
Great for plan selectors, preference choices, or any short list of options.
Use single mode as a more visual alternative to radio buttons.
Validation
This component uses select validation. See the Validation Guide for details on configuring rules and error messages.