# Toolbar

Data-driven toolbar with roving focus, action presentations and tones, and toggle groups.

Use Toolbar for related actions that need coordinated keyboard focus. Choose icon, label, or both for each item. Give every icon-only action a specific label. For toggle groups, `value` and `defaultValue` initialize uncontrolled state. Set `controlled: true` when each update must read the current `value`.

## API

The package declarations define these public members.

| Member | Type | Kind | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `items` | `ToolbarItem[]` | prop | Yes | - | Declarative item list: buttons, links, separators, and toggle groups. |
| `label` | `string` | prop | No | `undefined` | Accessible name for the `role="toolbar"` region. |
| `size` | `ControlSize` | prop | No | `'md'` | No additional description. |

## Related

- [Button](/docs/components/button): Primary action control or link with variants and loading state.
- [Chip](/docs/components/chip): Bindable toggle pill for compact filters on the shared control ladder.
- [CopyButton](/docs/components/copy-button): Clipboard action with temporary copied feedback.