ButtonGroup

1.0.0

A 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>

Related