Toolbar
Group related actions with directional keyboard navigation.
Installation
pnpm dlx shadcn@4.18.0 add @siteplane/toolbarComplete the one-time setup first. Registry JSON lists source files and dependencies.
For this page’s examples, also install:
pnpm dlx shadcn@4.18.0 add @siteplane/button @siteplane/select @siteplane/toggle-group @siteplane/tooltipUsage
import { Toolbar, ToolbarButton } from "@/siteplane/components/toolbar";
<Toolbar aria-label="Actions">
<ToolbarButton>Undo</ToolbarButton>
</Toolbar>;Composition
Toolbar
├── ToolbarGroup → ToolbarButton / ToolbarLink / ToolbarInput
├── ToolbarSeparator
└── ToolbarGroupAPI reference
| Prop | Type | Default | Description |
|---|---|---|---|
Toolbar | ToolbarPrimitive.Root.Props | Base UI defaults | orientation, loopFocus, disabled and native root props. |
Toolbar. | sm | md | lg | xl | provider / lg | Control size of its buttons, links, groups and input. ToolbarButton, ToolbarLink and ToolbarGroup also take size, which wins over the toolbar's; a group passes its size on to the controls inside it. |
Toolbar | ToolbarPrimitive.Button.Props | Kit ghost Button | disabled, focusableWhenDisabled, onClick and render. |
Toolbar | ToolbarPrimitive.Link.Props | Kit ghost Button rendered as an anchor | href and render for router integration. |
Toolbar | InputProps inset flags | — | Reserves space for input adornments. Other props follow ToolbarPrimitive.Input. |
Toolbar | ToolbarPrimitive.Group.Props | — | Related action group. |
Toolbar | ToolbarPrimitive.Separator.Props | Kit Separator | Visual and semantic separator. |
Toolbar | Base UI Toolbar namespace | — | Base UI parts and types. |
Usage notes
Give the toolbar and meaningful subgroups accessible labels. Native Tab enters the toolbar; arrow keys move among controls according to orientation. See Base UI Toolbar for exact focus, orientation and render behavior.