A container for a set of controls, such as text formatting options. The toolbar is one tab stop and arrow keys move between its items.
import Toolbar from "@radui/ui/Toolbar"- The whole toolbar is a single tab stop, with arrow keys moving between items
- Single or multiple selection toggle groups
- Separator orientation inferred from the toolbar's orientation
- Horizontal and vertical orientations
Import all parts of the component and piece them together.
The toolbar container. Renders a toolbar role and manages roving focus across its items.
| Prop | Type | Default |
|---|---|---|
aria-label | string | — |
orientation | "horizontal" | "vertical" | "horizontal" |
loop | boolean | false |
dir | "ltr" | "rtl" | "ltr" |
className | string | — |
asChild | boolean | false |
Groups related items; name it with aria-label. Arrow keys still move across the whole toolbar.
| Prop | Type | Default |
|---|---|---|
disabled | boolean | false |
asChild | boolean | false |
Groups toggle items so only one or many can be pressed at a time.
| Prop | Type | Default |
|---|---|---|
type | "single" | "multiple" | "single" |
value | any | — |
defaultValue | any | [] |
onValueChange | (value: any) => void | — |
disabled | boolean | false |
A pressable item inside a ToggleGroup. Must be rendered within Toolbar.ToggleGroup.
| Prop | Type | Default |
|---|---|---|
value | any | required |
aria-label | string | — |
disabled | boolean | false |
className | string | — |
An action button inside the toolbar. Must be rendered within Toolbar.Root.
| Prop | Type | Default |
|---|---|---|
aria-label | string | — |
className | string | — |
asChild | boolean | false |
disabled | boolean | false |
focusableWhenDisabled | boolean | false |
A link inside the toolbar. Part of the toolbar's single tab stop.
| Prop | Type | Default |
|---|---|---|
href | string | "#" |
aria-label | string | — |
className | string | — |
asChild | boolean | false |
A text field that's one stop in the toolbar's arrow-key navigation. ArrowLeft/ArrowRight move the caret and leave the field at its start or end.
| Prop | Type | Default |
|---|---|---|
type | string | 'text' |
aria-label | string | — |
focusableWhenDisabled | boolean | false |
A visual divider between toolbar groups. Defaults to the opposite orientation of the toolbar.
| Prop | Type | Default |
|---|---|---|
orientation | "horizontal" | "vertical" | inferred |
className | string | — |
| Shortcut | Description |
|---|---|
| ArrowRight | Moves focus to the next item in a horizontal toolbar. |
| ArrowDown | Moves focus to the next item in a vertical toolbar. |
| Space | Toggles the focused item. |
| Enter | Toggles the focused item. |
| Reference | What Rad UI follows |
|---|---|
| Button pattern | Buttons and toggle items are native buttons. In a multiple ToggleGroup (role="group") items expose aria-pressed; in a single ToggleGroup (role="radiogroup") items are role="radio" with aria-checked. The toolbar carries an accessible name via aria-label. |