> Source: https://laravilt.com/docs/forms/selection/toggle-buttons

# ToggleButtons

Button-style toggle for visual selection.

## Basic Usage

```php
<?php

use Laravilt\Forms\Components\ToggleButtons;

ToggleButtons::make('status')
    ->options([
        'draft' => 'Draft',
        'published' => 'Published',
        'archived' => 'Archived',
    ]);
```

## Grouped Buttons

```php
<?php

use Laravilt\Forms\Components\ToggleButtons;

ToggleButtons::make('alignment')
    ->options(['left' => 'Left', 'center' => 'Center', 'right' => 'Right'])
    ->grouped();
```

## With Icons

```php
<?php

use Laravilt\Forms\Components\ToggleButtons;

ToggleButtons::make('view_mode')
    ->options(['grid' => 'Grid', 'list' => 'List'])
    ->icons(['grid' => 'LayoutGrid', 'list' => 'List']);
```

## Multiple Selection

```php
<?php

use Laravilt\Forms\Components\ToggleButtons;

ToggleButtons::make('features')
    ->options(['bold' => 'B', 'italic' => 'I', 'underline' => 'U'])
    ->multiple()
    ->grouped();
```

## Vue Component

Uses Radix Vue ToggleGroup:

```vue
<script setup>
import { ToggleGroupRoot, ToggleGroupItem } from 'radix-vue'
</script>
```

## API Reference

| Method | Description |
|--------|-------------|
| `options()` | Set options |
| `grouped()` | Group buttons |
| `icons()` | Add icons |
| `boolean()` | Boolean mode |
| `multiple()` | Allow multiple |
| `colors()` | Color per option |