Skip to contentKino
Skip to Content

Menubar

A bar of menus, as in a desktop app, that you move across with the pointer or the arrow keys.

npx shadcn add https://kinoui.com/r/menubar.json
Share on

Examples

Default

Open one menu, then move across the others with the pointer or the arrow keys.

Installation

npx shadcn@latest add https://kinoui.com/r/menubar.json
Files
lib/reduce-motion.tslib/scroll.tscomponents/kino/separator.tsxlib/popup.tslib/resize.tslib/run-progress.tslib/highlight.tslib/menu.tsxcomponents/kino/menubar.tsx
Packages
@base-ui/reactclass-variance-authority

New to Kino? Installation covers what your project needs first and the @kino namespace.

API reference

PropTypeDefaultDescription
side'left''top''bottom''right''inline-start''inline-end''bottom'The side of the trigger it opens on. It moves to another side when there is no room.
align'start''center''end''start'How it lines up with the trigger along that side.
sideOffsetnumberfunction6The gap between it and the trigger, in pixels.
alignOffsetnumberfunction0How far it shifts along the side, in pixels.
classNamestringNoneGoes to the list of items inside the box, 12rem to 20rem wide, unless you set a width.
PropTypeDefaultDescription
variant'default''destructive''default'Destructive is for an action that deletes or can’t be undone.
closeOnClickbooleantrueWhether picking it closes the menu.
PropTypeDefaultDescription
checkedbooleanNoneWhether it is on, when you hold the state.
defaultCheckedbooleanfalseWhether it is on at first, when you leave the state to the item.
onCheckedChange(checked, details) => voidNoneCalled when it turns on or off.

Data attributes

AttributeOnDescription
data-highlightedMenubarItem and the other itemsPresent on the item the highlight is on.
data-checkedMenubarCheckboxItem, MenubarRadioItemPresent while it is on or picked.
data-disabledevery itemPresent while it is disabled.
data-popup-openMenubarSubTrigger and the triggerPresent while its menu is open.

Accessibility

  • The left and right arrows move along the bar; with a menu open, they open the next menu. The down arrow opens a menu on its first item.
  • Arrow keys move between items, Home and End go to the first and the last, and typing a letter goes to the next item that starts with it.
  • Enter or Space picks an item. The arrow that points into a submenu opens it, and the other arrow or Escape closes it.
  • Focus goes back to the trigger when the menu closes.
  • A checkbox item is announced as checked or not, and a radio item as picked or not. On screen a checked item shows its tick, and a picked radio item its tint and medium label, so neither relies on colour alone.
  • When the system asks for less motion, menus only fade and the highlight moves at once.