ButtonGroup
1.0.0A container that groups related buttons together with consistent styling.
Component data
- ID
- button-group
- Category
- atoms
- Version
- 1.0.0
- Added
- 2026-09-17
- Type
- component
- Keyboard nav
- Yes
- Reduced motion
- Yes
button-groupbuttontoolbarsplit-buttonatom
Dependencies
- @base-ui/react
- clsx
- tailwind-merge
Registry
- separator
- button
Examples
Default
<ButtonGroup>
<Button variant="secondary">{buttonGroupMocks.default.first}</Button>
<Button variant="secondary">{buttonGroupMocks.default.second}</Button>
</ButtonGroup>Variants
<div className="flex flex-col items-start gap-8">
<ButtonGroup orientation="vertical">
<Button variant="secondary" size="sm" aria-label="Increase">
<PlusIcon />
</Button>
<Button variant="secondary" size="sm" aria-label="Decrease">
<MinusIcon />
</Button>
</ButtonGroup>
<ButtonGroup>
<ButtonGroup>
<Button variant="secondary" size="sm">
{buttonGroupMocks.archive.first}
</Button>
<Button variant="secondary" size="sm">
{buttonGroupMocks.archive.second}
</Button>
</ButtonGroup>
<ButtonGroup>
<Button variant="secondary" size="sm" aria-label="Voice Mode">
<AudioLinesIcon />
</Button>
</ButtonGroup>
</ButtonGroup>
<ButtonGroup>
<Button variant="ghost">{buttonGroupMocks.archive.first}</Button>
<ButtonGroupSeparator />
<Button variant="ghost">{buttonGroupMocks.archive.second}</Button>
</ButtonGroup>
<ButtonGroup>
<ButtonGroupText>{buttonGroupMocks.text.label}</ButtonGroupText>
<Input placeholder={buttonGroupMocks.input.placeholder} />
<Button variant="secondary">{buttonGroupMocks.input.action}</Button>
</ButtonGroup>
</div>
