Menubar
SaveAn application menubar with File, Edit, and View style menus, submenus, checkbox and radio items, and shortcuts, built on Base UI Menubar with the Dropdown Menu surface.
- Category
- Overlays
- Version
- 0.1.1
- Frameworks
- Next.js, Vite + React
- Styling
- Tailwind CSS v4
Preview
Menubar preview
Installation
npx @shakenui/cli add menubarReview the plan first. A dry run lists every file and package without changing anything:
npx @shakenui/cli add menubar --dry-runUsage
menubar-example.tsx
"use client";
import { useState } from "react";
import {
Menubar,
MenubarCheckboxItem,
MenubarContent,
MenubarGroup,
MenubarItem,
MenubarLabel,
MenubarMenu,
MenubarRadioGroup,
MenubarRadioItem,
MenubarSeparator,
MenubarShortcut,
MenubarSub,
MenubarSubContent,
MenubarSubTrigger,
MenubarTrigger,
} from "@/components/shaken/ui/menubar";
const recent = ["acme-web", "agent-runtime", "billing-service"];
export default function MenubarExample() {
const [wordWrap, setWordWrap] = useState(true);
const [minimap, setMinimap] = useState(false);
const [panel, setPanel] = useState("bottom");
return (
<Menubar>
<MenubarMenu>
<MenubarTrigger>File</MenubarTrigger>
<MenubarContent>
<MenubarItem>
New file
<MenubarShortcut>⌘N</MenubarShortcut>
</MenubarItem>
<MenubarItem>
Open…
<MenubarShortcut>⌘O</MenubarShortcut>
</MenubarItem>
<MenubarSub>
<MenubarSubTrigger>Open recent</MenubarSubTrigger>
<MenubarSubContent>
{recent.map((name) => (
<MenubarItem key={name}>
<span className="font-mono text-xs">{name}</span>
</MenubarItem>
))}
<MenubarSeparator />
<MenubarItem>Clear recent</MenubarItem>
</MenubarSubContent>
</MenubarSub>
<MenubarSeparator />
<MenubarItem>
Save
<MenubarShortcut>⌘S</MenubarShortcut>
</MenubarItem>
<MenubarItem disabled>
Save all
<MenubarShortcut>⌥⌘S</MenubarShortcut>
</MenubarItem>
<MenubarSeparator />
<MenubarItem destructive>Close workspace</MenubarItem>
</MenubarContent>
</MenubarMenu>
<MenubarMenu>
<MenubarTrigger>Edit</MenubarTrigger>
<MenubarContent>
<MenubarItem>
Undo
<MenubarShortcut>⌘Z</MenubarShortcut>
</MenubarItem>
<MenubarItem>
Redo
<MenubarShortcut>⇧⌘Z</MenubarShortcut>
</MenubarItem>
<MenubarSeparator />
<MenubarItem>
Find
<MenubarShortcut>⌘F</MenubarShortcut>
</MenubarItem>
<MenubarItem>
Replace
<MenubarShortcut>⌥⌘F</MenubarShortcut>
</MenubarItem>
</MenubarContent>
</MenubarMenu>
<MenubarMenu>
<MenubarTrigger>View</MenubarTrigger>
<MenubarContent>
<MenubarCheckboxItem checked={wordWrap} onCheckedChange={setWordWrap}>
Word wrap
<MenubarShortcut>⌥Z</MenubarShortcut>
</MenubarCheckboxItem>
<MenubarCheckboxItem checked={minimap} onCheckedChange={setMinimap}>
Minimap
</MenubarCheckboxItem>
<MenubarSeparator />
<MenubarRadioGroup value={panel} onValueChange={setPanel}>
<MenubarLabel>Panel position</MenubarLabel>
<MenubarRadioItem value="bottom">Bottom</MenubarRadioItem>
<MenubarRadioItem value="right">Right</MenubarRadioItem>
<MenubarRadioItem value="hidden">Hidden</MenubarRadioItem>
</MenubarRadioGroup>
</MenubarContent>
</MenubarMenu>
<MenubarMenu>
<MenubarTrigger>Agent</MenubarTrigger>
<MenubarContent>
<MenubarGroup>
<MenubarItem>
Start run
<MenubarShortcut>⌘R</MenubarShortcut>
</MenubarItem>
<MenubarItem disabled>
Stop run
<MenubarShortcut>⌘.</MenubarShortcut>
</MenubarItem>
<MenubarItem>Review pending approvals</MenubarItem>
</MenubarGroup>
<MenubarSeparator />
<MenubarItem>Open trace</MenubarItem>
</MenubarContent>
</MenubarMenu>
</Menubar>
);
}API
| Prop | Type | Default | Description |
|---|---|---|---|
| Menubar orientation | "horizontal" | "vertical" | "horizontal" | Which arrow keys move between menus. |
| Menubar loopFocus | boolean | true | Wraps arrow-key focus from the last menu to the first. |
| Menubar disabled | boolean | false | Disables every menu in the bar. |
| MenubarMenu | Base UI Menu.Root props | — | One menu: a MenubarTrigger and its MenubarContent. |
| MenubarTrigger | Base UI Menu.Trigger props | — | The label in the bar, such as File. Tinted while its menu is open. |
| MenubarContent side / align / sideOffset / alignOffset | Dropdown Menu content props | "bottom" / "start" / 6 / -4 | Placement under the trigger. |
| MenubarItem / MenubarCheckboxItem / MenubarRadioGroup / MenubarRadioItem | Dropdown Menu and Context Menu item props | — | Actions, toggles, and single choices, with destructive and disabled states. |
| MenubarSub / MenubarSubTrigger / MenubarSubContent | Context Menu submenu parts | — | Nested menus beside their trigger. |
| MenubarGroup / MenubarLabel / MenubarSeparator / MenubarShortcut | Dropdown Menu parts | — | Grouping, labels, dividers, and shortcut hints. |
Accessibility
- The bar has role="menubar" and its triggers are menuitems with aria-haspopup and aria-expanded.
- Left and right arrows move between triggers; Enter, Space, or the down arrow opens a menu with its first item highlighted.
- While a menu is open, the left and right arrows and hovering another trigger switch menus; the swap is instant with no animation.
- Inside a menu, arrows, Home, End, and typeahead move the highlight; Escape closes the menu and returns focus to its trigger.
- Checkbox and radio items announce their state with aria-checked; disabled items stay reachable.
- With reduced motion the menu transitions are removed.
Files
Installed into src/components/shaken, or components/shaken when the project has no src directory.
src/components/shaken/ui/menubar.tsxmenubar- Also installs dropdown-menu@0.2.1registry dependency
- Also installs context-menu@0.1.1registry dependency
- npm packages: @base-ui/react@^1.9.0React and Tailwind CSS v4 required
Source
The exact source the CLI installs, from /r/items/react/menubar/0.1.1.json.
ui/menubar.tsxShowHide
ui/menubar.tsx
"use client";
import { Menu as BaseMenu } from "@base-ui/react/menu";
import { Menubar as BaseMenubar } from "@base-ui/react/menubar";
import {
ContextMenuCheckboxItem,
ContextMenuRadioGroup,
ContextMenuRadioItem,
ContextMenuSub,
ContextMenuSubContent,
ContextMenuSubTrigger,
} from "./context-menu";
import {
DropdownMenuContent,
type DropdownMenuContentProps,
DropdownMenuGroup,
DropdownMenuItem,
DropdownMenuLabel,
DropdownMenuSeparator,
DropdownMenuShortcut,
} from "./dropdown-menu";
type ClassName<State> = string | ((state: State) => string | undefined) | undefined;
function cx(...classes: (string | false | null | undefined)[]) {
return classes.filter(Boolean).join(" ");
}
/** Prepends base classes while keeping Base UI's state-function form of className working. */
function withBase<State>(base: string, className: ClassName<State>) {
return typeof className === "function" ? (state: State) => cx(base, className(state)) : cx(base, className);
}
/**
* The bar that holds the menus. Left and right arrows move between menu triggers, and once one
* menu is open, hovering or arrowing to the next trigger opens that menu instead.
*/
export function Menubar({ className, ...props }: BaseMenubar.Props) {
return (
<BaseMenubar
className={withBase(
cx(
"flex h-10 items-center gap-0.5 rounded-xl border border-zinc-950/10 bg-white p-1 text-zinc-950",
"shadow-[0_1px_2px_rgb(0_0_0/0.04)] dark:border-white/10 dark:bg-black dark:text-white dark:shadow-[inset_0_1px_0_rgb(255_255_255/0.06)]",
),
className,
)}
{...props}
/>
);
}
/** One menu in the bar: a MenubarTrigger and its MenubarContent. */
export const MenubarMenu = BaseMenu.Root;
/** The label in the bar that opens a menu, such as File or Edit. */
export function MenubarTrigger({ className, ...props }: BaseMenu.Trigger.Props) {
return (
<BaseMenu.Trigger
className={withBase(
cx(
"inline-flex h-8 cursor-default items-center rounded-lg px-2.5 text-sm font-medium text-zinc-700 outline-none select-none",
// Colors only: moving between menus is quick and frequent, so nothing slides.
"transition-colors duration-150 ease-out motion-reduce:transition-none",
"hover:bg-zinc-950/[0.04] hover:text-zinc-950 data-[popup-open]:bg-zinc-950/[0.06] data-[popup-open]:text-zinc-950",
"dark:text-zinc-300 dark:hover:bg-white/[0.06] dark:hover:text-white dark:data-[popup-open]:bg-white/[0.09] dark:data-[popup-open]:text-white",
"focus-visible:outline-2 focus-visible:outline-solid focus-visible:-outline-offset-2 focus-visible:outline-sky-500",
"data-[disabled]:pointer-events-none data-[disabled]:opacity-45",
),
className,
)}
{...props}
/>
);
}
export interface MenubarContentProps extends DropdownMenuContentProps {}
/**
* A menu's panel. Shares its surface with Dropdown Menu. When focus moves from one open menu to
* the next, the swap is instant rather than animated.
*/
export function MenubarContent({ sideOffset = 6, alignOffset = -4, className, ...props }: MenubarContentProps) {
return (
<DropdownMenuContent
sideOffset={sideOffset}
alignOffset={alignOffset}
className={withBase("data-[instant]:transition-none", className)}
{...props}
/>
);
}
/** An action. `destructive` styles it for deleting; `disabled` keeps it visible but skips it. */
export const MenubarItem = DropdownMenuItem;
/** Groups related items. Put a MenubarLabel inside to name the group. */
export const MenubarGroup = DropdownMenuGroup;
/** Names a MenubarGroup or MenubarRadioGroup. Must be rendered inside the group it labels. */
export const MenubarLabel = DropdownMenuLabel;
/** A divider between groups of items. */
export const MenubarSeparator = DropdownMenuSeparator;
/** A keyboard shortcut hint shown at the end of an item. */
export const MenubarShortcut = DropdownMenuShortcut;
/** An item that toggles a setting, with a check in the leading slot when on. */
export const MenubarCheckboxItem = ContextMenuCheckboxItem;
/** Groups radio items so exactly one is chosen. */
export const MenubarRadioGroup = ContextMenuRadioGroup;
/** One choice in a MenubarRadioGroup. */
export const MenubarRadioItem = ContextMenuRadioItem;
/** Groups a submenu trigger with its panel. */
export const MenubarSub = ContextMenuSub;
/** An item that opens a submenu on hover, click, or the right arrow key. */
export const MenubarSubTrigger = ContextMenuSubTrigger;
/** The submenu panel, beside its trigger. */
export const MenubarSubContent = ContextMenuSubContent;