# Toolbar Documentation Displays frequently used actions or tools in a compact and easily accessible bar. This is a documentation section that potentially contains examples, demos, and other useful information related to a specific part of Bits UI. When helping users with this documentation, you can ignore the classnames applied to the demos unless they are relevant to the user's issue. Copy Page ```svelte

Ask AI

``` ## Structure ```svelte ``` ## Managing Value State This section covers how to manage the `value` state of the component. ### Two-Way Binding Use `bind:value` for simple, automatic state synchronization: ```svelte ``` ### Fully Controlled Use a [Function Binding](https://svelte.dev/docs/svelte/bind#Function-bindings) for complete control over the state's reads and writes. ```svelte ``` ## API Reference ### Toolbar.Root The root component which contains the toolbar. | Property | Type | Description | Details | | --------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------- | | `loop` | `boolean` | Whether or not the toolbar should loop when navigating.`Default: true` | | | `orientation` | `enum` - 'horizontal' \| 'vertical' | The orientation of the toolbar.`Default: 'horizontal'` | | | `ref` $bindable | `HTMLDivElement` | The underlying DOM element being rendered. You can bind to this to get a reference to the element.`Default: null` | | | `children` | `Snippet` | The children content to render.`Default: —— undefined` | | | `child` | `Snippet` - type SnippetProps = { props: Record\; }; | Use render delegation to render your own element. See [Child Snippet](/docs/child-snippet) docs for more information.`Default: —— undefined` | | | Data Attribute | Value | Description | Details | | ------------------- | ----------------------------------- | --------------------------------- | ------- | | `data-orientation` | `enum` - 'vertical' \| 'horizontal' | The orientation of the component. | | | `data-toolbar-root` | `''` | Present on the root element. | | ### Toolbar.Button A button in the toolbar. | Property | Type | Description | Details | | --------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------- | | `disabled` | `boolean` | Whether or not the button is disabled.`Default: false` | | | `ref` $bindable | `HTMLButtonElement` | The underlying DOM element being rendered. You can bind to this to get a reference to the element.`Default: null` | | | `children` | `Snippet` | The children content to render.`Default: —— undefined` | | | `child` | `Snippet` - type SnippetProps = { props: Record\; }; | Use render delegation to render your own element. See [Child Snippet](/docs/child-snippet) docs for more information.`Default: —— undefined` | | | Data Attribute | Value | Description | Details | | --------------------- | ----- | ------------------------------ | ------- | | `data-toolbar-button` | `''` | Present on the button element. | | ### Toolbar.Link A link in the toolbar. | Property | Type | Description | Details | | --------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------- | | `ref` $bindable | `HTMLAnchorElement` | The underlying DOM element being rendered. You can bind to this to get a reference to the element.`Default: null` | | | `children` | `Snippet` | The children content to render.`Default: —— undefined` | | | `child` | `Snippet` - type SnippetProps = { props: Record\; }; | Use render delegation to render your own element. See [Child Snippet](/docs/child-snippet) docs for more information.`Default: —— undefined` | | | Data Attribute | Value | Description | Details | | ------------------- | ----- | ---------------------------- | ------- | | `data-toolbar-link` | `''` | Present on the link element. | | ### Toolbar.Group A group of toggle items in the toolbar. | Property | Type | Description | Details | | ----------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------- | | `type` required | `enum` - 'single' \| 'multiple' | The type of the component, used to determine the type of the value, when `'multiple'` the value will be an array.`Default: —— undefined` | | | `value` $bindable | `union` - string \| string\[] | The value of the toggle group. If the type is multiple, this will be an array of strings, otherwise it will be a string.`Default: —— undefined` | | | `onValueChange` | `function` - (value: string) => void \| (value: string\[]) => void | A callback function called when the value changes.`Default: —— undefined` | | | `disabled` | `boolean` | Whether or not the switch is disabled.`Default: false` | | | `ref` $bindable | `HTMLDivElement` | The underlying DOM element being rendered. You can bind to this to get a reference to the element.`Default: null` | | | `children` | `Snippet` | The children content to render.`Default: —— undefined` | | | `child` | `Snippet` - type SnippetProps = { props: Record\; }; | Use render delegation to render your own element. See [Child Snippet](/docs/child-snippet) docs for more information.`Default: —— undefined` | | | Data Attribute | Value | Description | Details | | -------------------- | ----- | ----------------------------- | ------- | | `data-toolbar-group` | `''` | Present on the group element. | | ### Toolbar.GroupItem A toggle item in the toolbar toggle group. | Property | Type | Description | Details | | ---------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | | `value` required | `string` | The value of the toolbar toggle group item. When the toolbar toggle group item is selected, toolbar the toggle group's value will be set to this value if in single mode, or this value will be pushed to the toggle group's array value if in multiple mode.`Default: —— undefined` | | | `disabled` | `boolean` | Whether or not the item is disabled.`Default: false` | | | `ref` $bindable | `HTMLButtonElement` | The underlying DOM element being rendered. You can bind to this to get a reference to the element.`Default: null` | | | `children` | `Snippet` | The children content to render.`Default: —— undefined` | | | `child` | `Snippet` - type SnippetProps = { props: Record\; }; | Use render delegation to render your own element. See [Child Snippet](/docs/child-snippet) docs for more information.`Default: —— undefined` | | | Data Attribute | Value | Description | Details | | ------------------- | ---------------------- | ---------------------------------------------------------- | ------- | | `data-state` | `enum` - 'on' \| 'off' | Whether the toolbar toggle item is in the on or off state. | | | `data-value` | `''` | The value of the toolbar toggle item. | | | `data-disabled` | `''` | Present when the toolbar toggle item is disabled. | | | `data-toolbar-item` | `''` | Present on the toolbar toggle item. | | [Previous Toggle Group](/docs/components/toggle-group) [Next Tooltip](/docs/components/tooltip)