# Button Group > Joins related buttons into one control, horizontally or vertically. Source: https://shellui.dev/docs/v0.4/components/form/button-group `ButtonGroup` is **new in v0.4**. It wraps a set of `Button`s, removes the gaps between them and squares the inner corners, so they read as one control. The buttons keep their own variants, sizes and click handlers. ## Installation ```bash shellui add button-group ``` ## Usage ### Basic ```razor ``` ### Vertical Set `Orientation="vertical"` to stack the buttons. ```razor ``` ### Showing a selection `ButtonGroup` only handles layout. To highlight the active button, switch its `Variant` yourself. For a control that tracks its own value, use [Toggle Group](https://shellui.dev/docs/v0.4/components/form/toggle-group.md). ```razor @foreach (var range in ranges) { }

Showing: @selected

@code { private readonly string[] ranges = ["7 days", "30 days", "90 days"]; private string selected = "30 days"; } ``` ## API Reference | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `Orientation` | `string` | `"horizontal"` | `horizontal` or `vertical` | | `ChildContent` | `RenderFragment?` | `null` | The buttons | | `Class` | `string?` | `null` | Additional CSS classes | ## Accessibility - Renders a `role="group"` container; add `aria-label` to name the group - Each button keeps its own focus ring and keyboard behavior