Menubar

A row of menus that stays on screen and holds an application's commands.

import * as stylex from "@stylexjs/stylex"
import {
  Menubar,
  MenubarCheckboxItem,
  MenubarContent,
  MenubarGroup,
  MenubarItem,
  MenubarMenu,
  MenubarRadioGroup,
  MenubarRadioItem,
  MenubarSeparator,
  MenubarShortcut,
  MenubarSub,
  MenubarSubContent,
  MenubarSubTrigger,
  MenubarTrigger,
} from "@/components/ui/menubar"

const styles = stylex.create({ menubar: { width: "18rem" }, content: { width: "11rem" } })

export default function MenubarDemo() {
  return (
    <Menubar xstyle={styles.menubar}>
      <MenubarMenu>
        <MenubarTrigger>File</MenubarTrigger>
        <MenubarContent>
          <MenubarGroup>
            <MenubarItem>
              New Document <MenubarShortcut>⌘N</MenubarShortcut>
            </MenubarItem>
            <MenubarItem>
              Open... <MenubarShortcut>⌘O</MenubarShortcut>
            </MenubarItem>
            <MenubarItem disabled>Import...</MenubarItem>
          </MenubarGroup>
          <MenubarSeparator />
          <MenubarGroup>
            <MenubarSub>
              <MenubarSubTrigger>Export</MenubarSubTrigger>
              <MenubarSubContent>
                <MenubarGroup>
                  <MenubarItem>PDF</MenubarItem>
                  <MenubarItem>Markdown</MenubarItem>
                  <MenubarItem>Plain Text</MenubarItem>
                </MenubarGroup>
              </MenubarSubContent>
            </MenubarSub>
          </MenubarGroup>
          <MenubarSeparator />
          <MenubarGroup>
            <MenubarItem>
              Print... <MenubarShortcut>⌘P</MenubarShortcut>
            </MenubarItem>
          </MenubarGroup>
        </MenubarContent>
      </MenubarMenu>
      <MenubarMenu>
        <MenubarTrigger>Edit</MenubarTrigger>
        <MenubarContent>
          <MenubarGroup>
            <MenubarItem>
              Undo <MenubarShortcut>⌘Z</MenubarShortcut>
            </MenubarItem>
            <MenubarItem>
              Redo <MenubarShortcut>⇧⌘Z</MenubarShortcut>
            </MenubarItem>
          </MenubarGroup>
          <MenubarSeparator />
          <MenubarGroup>
            <MenubarSub>
              <MenubarSubTrigger>Find</MenubarSubTrigger>
              <MenubarSubContent>
                <MenubarGroup>
                  <MenubarItem>Find in All Documents</MenubarItem>
                </MenubarGroup>
                <MenubarSeparator />
                <MenubarGroup>
                  <MenubarItem>Find...</MenubarItem>
                  <MenubarItem>Find Next</MenubarItem>
                  <MenubarItem>Find Previous</MenubarItem>
                </MenubarGroup>
              </MenubarSubContent>
            </MenubarSub>
          </MenubarGroup>
          <MenubarSeparator />
          <MenubarGroup>
            <MenubarItem>Cut</MenubarItem>
            <MenubarItem>Copy</MenubarItem>
            <MenubarItem>Paste</MenubarItem>
          </MenubarGroup>
        </MenubarContent>
      </MenubarMenu>
      <MenubarMenu>
        <MenubarTrigger>View</MenubarTrigger>
        <MenubarContent xstyle={styles.content}>
          <MenubarGroup>
            <MenubarCheckboxItem>Ruler</MenubarCheckboxItem>
            <MenubarCheckboxItem defaultChecked>Word Count</MenubarCheckboxItem>
          </MenubarGroup>
          <MenubarSeparator />
          <MenubarGroup>
            <MenubarItem inset>
              Zoom In <MenubarShortcut>⌘+</MenubarShortcut>
            </MenubarItem>
            <MenubarItem disabled inset>
              Zoom Out <MenubarShortcut>⌘-</MenubarShortcut>
            </MenubarItem>
          </MenubarGroup>
          <MenubarSeparator />
          <MenubarGroup>
            <MenubarItem inset>Focus Mode</MenubarItem>
          </MenubarGroup>
          <MenubarSeparator />
          <MenubarGroup>
            <MenubarItem inset>Hide Outline</MenubarItem>
          </MenubarGroup>
        </MenubarContent>
      </MenubarMenu>
      <MenubarMenu>
        <MenubarTrigger>Accounts</MenubarTrigger>
        <MenubarContent>
          <MenubarRadioGroup defaultValue="alan">
            <MenubarRadioItem value="ada">Ada</MenubarRadioItem>
            <MenubarRadioItem value="alan">Alan</MenubarRadioItem>
            <MenubarRadioItem value="emmy">Emmy</MenubarRadioItem>
          </MenubarRadioGroup>
          <MenubarSeparator />
          <MenubarGroup>
            <MenubarItem inset>Manage...</MenubarItem>
          </MenubarGroup>
          <MenubarSeparator />
          <MenubarGroup>
            <MenubarItem inset>Add Account...</MenubarItem>
          </MenubarGroup>
        </MenubarContent>
      </MenubarMenu>
    </Menubar>
  )
}

Installation

pnpm dlx shadcn@latest add @arene/menubar

Needs the arene setup first. Also adds Dropdown Menu.

Usage

import {
  Menubar,
  MenubarContent,
  MenubarGroup,
  MenubarItem,
  MenubarMenu,
  MenubarSeparator,
  MenubarShortcut,
  MenubarTrigger,
} from "@/components/ui/menubar"
<Menubar>
  <MenubarMenu>
    <MenubarTrigger>File</MenubarTrigger>
    <MenubarContent>
      <MenubarGroup>
        <MenubarItem>
          New Document <MenubarShortcut>⌘N</MenubarShortcut>
        </MenubarItem>
        <MenubarItem>Open...</MenubarItem>
      </MenubarGroup>
      <MenubarSeparator />
      <MenubarGroup>
        <MenubarItem>Export</MenubarItem>
        <MenubarItem>Print</MenubarItem>
      </MenubarGroup>
    </MenubarContent>
  </MenubarMenu>
</Menubar>

The menubar supports left-to-right layouts only.

Composition

A Menubar is built from these parts.

Menubar
├── MenubarMenu
│   ├── MenubarTrigger
│   └── MenubarContent
│       ├── MenubarGroup
│       │   ├── MenubarLabel
│       │   ├── MenubarItem
│       │   └── MenubarItem
│       ├── MenubarSeparator
│       ├── MenubarGroup
│       │   ├── MenubarLabel
│       │   ├── MenubarCheckboxItem
│       │   └── MenubarCheckboxItem
│       ├── MenubarSeparator
│       ├── MenubarGroup
│       │   ├── MenubarLabel
│       │   └── MenubarRadioGroup
│       │       ├── MenubarRadioItem
│       │       └── MenubarRadioItem
│       └── MenubarSub
│           ├── MenubarSubTrigger
│           └── MenubarSubContent
│               └── MenubarGroup
│                   ├── MenubarLabel
│                   ├── MenubarItem
│                   └── MenubarItem
└── MenubarMenu
    ├── MenubarTrigger
    └── MenubarContent
        └── MenubarGroup
            ├── MenubarLabel
            ├── MenubarItem
            └── MenubarItem

Checkbox

MenubarCheckboxItem turns an option on or off and shows a check while it is on.

import * as stylex from "@stylexjs/stylex"
import {
  Menubar,
  MenubarCheckboxItem,
  MenubarContent,
  MenubarItem,
  MenubarMenu,
  MenubarSeparator,
  MenubarShortcut,
  MenubarTrigger,
} from "@/components/ui/menubar"

const styles = stylex.create({ menubar: { width: "18rem" }, content: { width: "16rem" } })

export default function MenubarCheckbox() {
  return (
    <Menubar xstyle={styles.menubar}>
      <MenubarMenu>
        <MenubarTrigger>View</MenubarTrigger>
        <MenubarContent xstyle={styles.content}>
          <MenubarCheckboxItem>Always Show Ruler</MenubarCheckboxItem>
          <MenubarCheckboxItem defaultChecked>Always Show Word Count</MenubarCheckboxItem>
          <MenubarSeparator />
          <MenubarItem inset>
            Zoom In <MenubarShortcut>⌘+</MenubarShortcut>
          </MenubarItem>
          <MenubarItem disabled inset>
            Zoom Out <MenubarShortcut>⌘-</MenubarShortcut>
          </MenubarItem>
        </MenubarContent>
      </MenubarMenu>
      <MenubarMenu>
        <MenubarTrigger>Format</MenubarTrigger>
        <MenubarContent>
          <MenubarCheckboxItem defaultChecked>Small Caps</MenubarCheckboxItem>
          <MenubarCheckboxItem>Subscript</MenubarCheckboxItem>
          <MenubarCheckboxItem>Highlight</MenubarCheckboxItem>
        </MenubarContent>
      </MenubarMenu>
    </Menubar>
  )
}

Radio

Put MenubarRadioItems in a MenubarRadioGroup when only one option can be on at a time.

"use client"

import * as React from "react"
import * as stylex from "@stylexjs/stylex"

import {
  Menubar,
  MenubarContent,
  MenubarItem,
  MenubarMenu,
  MenubarRadioGroup,
  MenubarRadioItem,
  MenubarSeparator,
  MenubarTrigger,
} from "@/components/ui/menubar"

const styles = stylex.create({ menubar: { width: "18rem" } })

export default function MenubarRadio() {
  const [user, setUser] = React.useState("alan")
  const [theme, setTheme] = React.useState("system")

  return (
    <Menubar xstyle={styles.menubar}>
      <MenubarMenu>
        <MenubarTrigger>Accounts</MenubarTrigger>
        <MenubarContent>
          <MenubarRadioGroup value={user} onValueChange={setUser}>
            <MenubarRadioItem value="ada">Ada</MenubarRadioItem>
            <MenubarRadioItem value="alan">Alan</MenubarRadioItem>
            <MenubarRadioItem value="emmy">Emmy</MenubarRadioItem>
          </MenubarRadioGroup>
          <MenubarSeparator />
          <MenubarItem inset>Manage...</MenubarItem>
          <MenubarItem inset>Add Account...</MenubarItem>
        </MenubarContent>
      </MenubarMenu>
      <MenubarMenu>
        <MenubarTrigger>Theme</MenubarTrigger>
        <MenubarContent>
          <MenubarRadioGroup value={theme} onValueChange={setTheme}>
            <MenubarRadioItem value="light">Light</MenubarRadioItem>
            <MenubarRadioItem value="dark">Dark</MenubarRadioItem>
            <MenubarRadioItem value="system">System</MenubarRadioItem>
          </MenubarRadioGroup>
        </MenubarContent>
      </MenubarMenu>
    </Menubar>
  )
}

Nest a menu in a MenubarSub. MenubarSubTrigger is the row that opens it, and MenubarSubContent holds its items.

import * as stylex from "@stylexjs/stylex"
import {
  Menubar,
  MenubarContent,
  MenubarItem,
  MenubarMenu,
  MenubarSeparator,
  MenubarShortcut,
  MenubarSub,
  MenubarSubContent,
  MenubarSubTrigger,
  MenubarTrigger,
} from "@/components/ui/menubar"

const styles = stylex.create({ menubar: { width: "18rem" } })

export default function MenubarSubmenu() {
  return (
    <Menubar xstyle={styles.menubar}>
      <MenubarMenu>
        <MenubarTrigger>File</MenubarTrigger>
        <MenubarContent>
          <MenubarSub>
            <MenubarSubTrigger>Export</MenubarSubTrigger>
            <MenubarSubContent>
              <MenubarItem>PDF</MenubarItem>
              <MenubarItem>Markdown</MenubarItem>
              <MenubarItem>Plain Text</MenubarItem>
            </MenubarSubContent>
          </MenubarSub>
          <MenubarSeparator />
          <MenubarItem>
            Print... <MenubarShortcut>⌘P</MenubarShortcut>
          </MenubarItem>
        </MenubarContent>
      </MenubarMenu>
      <MenubarMenu>
        <MenubarTrigger>Edit</MenubarTrigger>
        <MenubarContent>
          <MenubarItem>
            Undo <MenubarShortcut>⌘Z</MenubarShortcut>
          </MenubarItem>
          <MenubarItem>
            Redo <MenubarShortcut>⇧⌘Z</MenubarShortcut>
          </MenubarItem>
          <MenubarSeparator />
          <MenubarSub>
            <MenubarSubTrigger>Find</MenubarSubTrigger>
            <MenubarSubContent>
              <MenubarItem>Find...</MenubarItem>
              <MenubarItem>Find Next</MenubarItem>
              <MenubarItem>Find Previous</MenubarItem>
            </MenubarSubContent>
          </MenubarSub>
          <MenubarSeparator />
          <MenubarItem>Cut</MenubarItem>
          <MenubarItem>Copy</MenubarItem>
          <MenubarItem>Paste</MenubarItem>
        </MenubarContent>
      </MenubarMenu>
    </Menubar>
  )
}

With icons

Place an icon before an item's label. The item sizes it.

import * as stylex from "@stylexjs/stylex"
import { FileIcon } from "@phosphor-icons/react/dist/csr/File"
import { FolderIcon } from "@phosphor-icons/react/dist/csr/Folder"
import { QuestionIcon } from "@phosphor-icons/react/dist/csr/Question"
import { FloppyDiskIcon } from "@phosphor-icons/react/dist/csr/FloppyDisk"
import { GearIcon } from "@phosphor-icons/react/dist/csr/Gear"
import { TrashIcon } from "@phosphor-icons/react/dist/csr/Trash"

import {
  Menubar,
  MenubarContent,
  MenubarGroup,
  MenubarItem,
  MenubarMenu,
  MenubarSeparator,
  MenubarShortcut,
  MenubarTrigger,
} from "@/components/ui/menubar"

const styles = stylex.create({ menubar: { width: "18rem" } })

export default function MenubarIcons() {
  return (
    <Menubar xstyle={styles.menubar}>
      <MenubarMenu>
        <MenubarTrigger>File</MenubarTrigger>
        <MenubarContent>
          <MenubarItem>
            <FileIcon aria-hidden="true" />
            New File <MenubarShortcut>⌘N</MenubarShortcut>
          </MenubarItem>
          <MenubarItem>
            <FolderIcon aria-hidden="true" />
            Open Folder
          </MenubarItem>
          <MenubarSeparator />
          <MenubarItem>
            <FloppyDiskIcon aria-hidden="true" />
            Save <MenubarShortcut>⌘S</MenubarShortcut>
          </MenubarItem>
        </MenubarContent>
      </MenubarMenu>
      <MenubarMenu>
        <MenubarTrigger>More</MenubarTrigger>
        <MenubarContent>
          <MenubarGroup>
            <MenubarItem>
              <GearIcon aria-hidden="true" />
              Settings
            </MenubarItem>
            <MenubarItem>
              <QuestionIcon aria-hidden="true" />
              Help
            </MenubarItem>
            <MenubarSeparator />
            <MenubarItem variant="destructive">
              <TrashIcon aria-hidden="true" />
              Delete
            </MenubarItem>
          </MenubarGroup>
        </MenubarContent>
      </MenubarMenu>
    </Menubar>
  )
}

API reference

Menubar accepts Base UI Menubar props. Menu parts accept their Dropdown Menu props, including render. Styled parts take xstyle, className and inline style.

PropTypeDefault
side"top" | "bottom" | "left" | "right" | "inline-start" | "inline-end""bottom"
sideOffsetnumber8
align"start" | "center" | "end""start"
alignOffsetnumber-4
KeyWhat it is
rootThe well and trigger spacing
verticalVertical arrangement
triggerTrigger type, nested corner, row-highlight hover
openThe raised key while the menu is open
contentMenu minimum width
focusRingShared keyboard focus ring

Data attributes

AttributeOnEffect
data-slot="menubar"rootBar anatomy
data-orientationrootHorizontal or vertical
data-open, data-disabledtriggerBase UI state
data-highlighted, data-disabled, data-checkeditemsBase UI state
data-inset, data-variantitemsItem appearance
data-side, data-starting-style, data-ending-stylepopupPlacement and transition state
data-slot="menubar-trigger"triggerPart anatomy
data-slot="menubar-content"contentPart anatomy
data-slot="menubar-group"groupPart anatomy
data-slot="menubar-item"itemPart anatomy
data-slot="menubar-label"labelPart anatomy
data-slot="menubar-separator"separatorPart anatomy
data-slot="menubar-shortcut"shortcutPart anatomy
data-slot="menubar-checkbox-item"checkbox-itemPart anatomy
data-slot="menubar-radio-group"radio-groupPart anatomy
data-slot="menubar-radio-item"radio-itemPart anatomy
data-slot="menubar-sub-trigger"sub-triggerPart anatomy
data-slot="menubar-sub-content"sub-contentPart anatomy

Checkbox and radio indicator spans retain their dropdown-menu-*-item-indicator slots. MenubarMenu, MenubarSub and MenubarPortal add no element.