# Button Group

Buttons joined edge to edge into one pixel-bordered strip.

Source: https://www.ui95.dev/ui/button-group

## Examples

```tsx
import { Button } from "@/components/ui/button"
import { ButtonGroup, ButtonGroupSeparator, ButtonGroupText } from "@/components/ui/button-group"

import type { ShowcaseDemo } from "../types"

export const demo: ShowcaseDemo = {
  span: "single",
  variants: [
    {
      label: "horizontal",
      render: () => (
        <ButtonGroup>
          <Button variant="outline">Left</Button>
          <Button variant="outline">Mid</Button>
          <Button variant="outline">Right</Button>
        </ButtonGroup>
      ),
    },
    {
      label: "vertical",
      render: () => (
        <ButtonGroup orientation="vertical">
          <Button variant="outline">Top</Button>
          <Button variant="outline">Mid</Button>
          <Button variant="outline">Bottom</Button>
        </ButtonGroup>
      ),
    },
    {
      label: "text and separator",
      render: () => (
        <ButtonGroup>
          <ButtonGroupText>Zoom</ButtonGroupText>
          <Button variant="outline">-</Button>
          <ButtonGroupSeparator />
          <Button variant="outline">+</Button>
        </ButtonGroup>
      ),
    },
    {
      label: "disabled",
      render: () => (
        <ButtonGroup>
          <Button variant="outline" disabled>
            Left
          </Button>
          <Button variant="outline" disabled>
            Right
          </Button>
        </ButtonGroup>
      ),
    },
  ],
}
```

## Installation

```bash
npx shadcn@latest add https://www.ui95.dev/r/button-group.json
```

Run it in a Radix shadcn project that already has the UI95 theme.

Dependencies:

```bash
npm install class-variance-authority cn radix-ui
```

Add these items first:

- [separator](https://www.ui95.dev/ui/separator)

`components/ui/button-group.tsx`

```tsx
import { cva, type VariantProps } from "class-variance-authority"
import { cn } from "cn"
import { Slot } from "radix-ui"

import { Separator } from "@/components/ui/separator"

const buttonGroupVariants = cva(
  "group/button-group flex w-fit items-stretch *:focus-visible:relative *:focus-visible:z-10 has-[>[data-slot=button-group]]:gap-2 [&>[data-slot=select-trigger]:not([class*='w-'])]:w-fit [&>input]:flex-1",
  {
    variants: {
      orientation: {
        horizontal: "[&>*:not(:first-child)]:-ml-(--pixel)",
        vertical: "flex-col [&>*:not(:first-child)]:-mt-(--pixel)",
      },
    },
    defaultVariants: {
      orientation: "horizontal",
    },
  }
)

function ButtonGroup({
  className,
  orientation,
  ...props
}: React.ComponentProps<"div"> & VariantProps<typeof buttonGroupVariants>) {
  return (
    <div
      role="group"
      data-slot="button-group"
      data-orientation={orientation}
      className={cn(buttonGroupVariants({ orientation }), className)}
      {...props}
    />
  )
}

function ButtonGroupText({
  className,
  asChild = false,
  ...props
}: React.ComponentProps<"div"> & {
  asChild?: boolean
}) {
  const Comp = asChild ? Slot.Root : "div"

  return (
    <Comp
      className={cn(
        "flex items-center gap-2 pixel-border border-border bg-muted px-2.5 font-pixel text-[16px] leading-none uppercase [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4",
        className
      )}
      {...props}
    />
  )
}

function ButtonGroupSeparator({
  className,
  orientation = "vertical",
  ...props
}: React.ComponentProps<typeof Separator>) {
  return (
    <Separator
      data-slot="button-group-separator"
      orientation={orientation}
      className={cn(
        "relative self-stretch data-horizontal:w-auto data-vertical:h-auto",
        className
      )}
      {...props}
    />
  )
}

export {
  ButtonGroup,
  ButtonGroupSeparator,
  ButtonGroupText,
  buttonGroupVariants,
}
```

## API reference

### ButtonGroup

| Prop | Type | Default |
| --- | --- | --- |
| `orientation` | `"vertical" \| "horizontal"` | `"horizontal"` |

### ButtonGroupSeparator

No props of its own. It forwards the props of the element or primitive it wraps.

### ButtonGroupText

| Prop | Type | Default |
| --- | --- | --- |
| `asChild` | `boolean` | `false` |
