GPUI Deck

Button Group

Connected horizontal/vertical buttons with an optional text slot.

Rendered by GPUI’s web backend from the real component. Requires a browser with WebGPU.

button_group.rs gives related Buttons one frame and decorative separators. It accepts existing Button instances, applies connected styling, and preserves their identity, actions, disabled state, and individual Tab stops.

ButtonGroup::new("calendar-month", "Calendar month", palette)
    .axis(Axis::Horizontal)
    .button(previous_month_button)
    .text("November 2026")
    .button(next_month_button)
    .w_full()

Horizontal is the default; Axis::Vertical stacks the same parts. text is a static label with no focus stop. Styled allows frame and size overrides. Focus uses an accent fill because the group owns the outer border. The group adds no arrow-key navigation or pressed-value state; ToggleGroup remains the control for multiple pressed values with roving focus.