

<Demo name="toggle-button-group/demos/default" />

## Installation [#installation]

<CodeBlockTabs defaultValue="npm">
  <CodeBlockTabsList>
    <CodeBlockTabsTrigger value="npm">
      npm
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="pnpm">
      pnpm
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="yarn">
      yarn
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="bun">
      bun
    </CodeBlockTabsTrigger>
  </CodeBlockTabsList>

  <CodeBlockTab value="npm">
    ```bash
    npx shadcn@latest add @dotui/toggle-button-group
    ```
  </CodeBlockTab>

  <CodeBlockTab value="pnpm">
    ```bash
    pnpm dlx shadcn@latest add @dotui/toggle-button-group
    ```
  </CodeBlockTab>

  <CodeBlockTab value="yarn">
    ```bash
    yarn dlx shadcn@latest add @dotui/toggle-button-group
    ```
  </CodeBlockTab>

  <CodeBlockTab value="bun">
    ```bash
    bun x shadcn@latest add @dotui/toggle-button-group
    ```
  </CodeBlockTab>
</CodeBlockTabs>

## Usage [#usage]

Use toggle button groups to let users toggle between multiple options.

```tsx
import { ToggleButton } from '@/components/ui/toggle-button'
import { ToggleButtonGroup } from '@/components/ui/toggle-button-group'
```

```tsx
<ToggleButtonGroup aria-label="Text alignment" defaultSelectedKeys={['left']}>
  <ToggleButton id="left">Left</ToggleButton>
  <ToggleButton id="center">Center</ToggleButton>
  <ToggleButton id="right">Right</ToggleButton>
</ToggleButtonGroup>
```

## Examples [#examples]

<Examples className="grid-cols-2">
  <Example name="toggle-button-group/demos/default" title="Default" />

  <Example name="toggle-button-group/demos/with-text" title="With Text" />

  <Example name="toggle-button-group/demos/variants" title="Variants" />

  <Example name="toggle-button-group/demos/sizes" title="Sizes" />

  <Example name="toggle-button-group/demos/vertical" title="Vertical" />

  <Example name="toggle-button-group/demos/multiple" title="Multiple" />
</Examples>

## API Reference [#api-reference]

<Reference name="toggle-button-group" />
