Toolbar

Last updated: October 14, 2026

Accessible toolbar for grouped controls with keyboard roving focus, Base UI and Radix twins.

Installation

npx smoothui-cli add toolbar

Features

  • Horizontal (default) and vertical orientation
  • Compound parts: ToolbarRoot, ToolbarGroup, ToolbarButton, ToolbarLink, ToolbarSeparator, ToolbarInput
  • Roving tabindex so arrow keys move between controls
  • Base UI by default; Radix twin available via style
  • disabled on the toolbar disables every button (and the input) in both twins

States

Features

A formatting bar with style buttons, actions, and a status link.

Vertical

Same controls stacked for side rails.

Accessibility

Keyboard

Arrow keys move focus within the toolbar. Home / End jump to the first / last item.

With the Radix twin, ToolbarInput is a native input that sits outside the toolbar's roving focus: it stays reachable with Tab, and the arrow keys keep moving its caret instead of jumping to the next control. The Base UI twin includes the input in roving focus.

ARIA Attributes

AttributeElementPurpose
role="toolbar"RootIdentifies the toolbar
aria-orientationRootvertical when stacked
role="group"GroupLabels a cluster of related controls

Props

ToolbarProps

Powered by

base-ui