Skip to main content
Button groups join related actions into a single visual unit. Borders between buttons merge, and only the outer corners stay rounded.

Basic Usage

Orientation

Horizontal (default) groups buttons side-by-side. Vertical stacks them:

Common Patterns

Pagination controls, view toggles, and segmented controls all benefit from button groups:

API Reference

ButtonGroup Parameters

orientation
str
default:"\"horizontal\""
Layout direction: "horizontal" or "vertical".
css_class
str | None
default:"None"
Additional Tailwind CSS classes appended to the component’s built-in styles.

Protocol Reference

ButtonGroup
{
  "type": "ButtonGroup",
  "children?": "[Component]",
  "orientation?": "horizontal | vertical",
  "cssClass?": "string"
}
For the complete protocol schema, see ButtonGroup.