Toolbar

Tab moves focus onto the toolbar exactly once; a second Tab leaves it. Controls are reached by the arrow keys via roving tabindex, never by Tab.

when role=toolbar (3+ controls)

ArrowRight focuses the next control and ArrowLeft the previous; with `loop` (default), ArrowRight past the last wraps to the first.

when a horizontal toolbar

The root exposes aria-orientation=vertical; ArrowDown / ArrowUp move between controls and ArrowLeft / ArrowRight do not rove.

when orientation=vertical

Home focuses the first control; End focuses the last.

when role=toolbar

ArrowLeft moves to the next (visually-left) control — arrow direction follows the locale, not the physical key.

when a horizontal toolbar under dir=rtl

A nested group adds no second tab stop; its items are traversed inline within the single toolbar arrow sequence (Shift+Tab is not trapped).

when a ToolbarToggleGroup or ToolbarGroup inside the bar

A disabled control still receives focus via the arrows (aria-disabled) but does not activate on Enter / Space / click.

when a disabled ToolbarButton / ToolbarToggleItem / ToolbarLink / ToolbarSplitButton

Exposes a non-empty accessible name via aria-label (the icon alone is not a name).

when an icon-only ToolbarButton / ToolbarToggleItem / ToolbarLink

Every enum axis reflects to its data-* attribute: data-variant, data-appearance, data-size, data-orientation, data-overflow (and data-elevated on a soft bar).

when always

Overflowing controls render inside the '…' dropdown menu and every action stays keyboard-reachable — none are dropped.

when overflow=collapse and the bar is narrower than its controls

The overflow menu entrance animates opacity only — no scale transform.

when prefers-reduced-motion: reduce

The input is an arrow-reachable roving member whose Arrow / Home / End move the caret (not focus); it is pinned in the bar while actions collapse and never renders as a menu row.

when a ToolbarInput in a collapsing bar

A toolbar needs an accessible name — pass aria-label or aria-labelledby.

when a roving toolbar with no aria-label / aria-labelledby

A search / text field needs an accessible name — pass aria-label or aria-labelledby (a placeholder is not a reliable name).

when a ToolbarInput with no aria-label / aria-labelledby

Adds exactly ONE tab stop: the menu half is tabIndex=-1; the two halves are one roving item reached by the perpendicular arrow axis, and roving-axis keys / Home / End pressed on the menu half are handed back to the bar.

when a ToolbarSplitButton in a roving toolbar

aria-haspopup / aria-expanded appear on the menu half only — never on the primary half or the wrapper — and the menu opens from the keyboard.

when a ToolbarSplitButton with a menu half

A ToolbarSplitButton counts once toward the roving threshold: two controls plus one stays a plain group; three turns roving on.

when the APG 3-control threshold

Both halves stay arrow-reachable and announced aria-disabled; neither activates, and the menu half is not a live trigger at all.

when a disabled ToolbarSplitButton

On collapse it becomes a primary menu row plus a submenu named by menuLabel; neither action is lost.

when a ToolbarSplitButton in an overflowing bar

Name the menu half for what it opens (e.g. “More save options”), not a copy of the primary — voice control has no other way to tell the halves apart.

when a ToolbarSplitButton whose menu half name equals the primary half's

An icon-only primary half needs an accessible name — pass aria-label (it names the button, not the wrapper).

when a ToolbarSplitButton with an icon-only primary half and no aria-label

It renders a variant=floating toolbar inside a role=dialog popover surface (sharing the bar's accessible name) and does not steal focus from the selection by default (autoFocus off).

when a ToolbarFloating bubble opens