# Menubar

A visually persistent menu common in desktop applications that provides quick access to a consistent set of commands.

Source: https://webjs.dev/ui/docs/components/menubar

```ts
import { html } from '@webjsdev/core';

export default function MenubarDemo() {
  return html`
    <ui-menubar class="w-72">
      <ui-menubar-menu>
        <ui-menubar-trigger>File</ui-menubar-trigger>
        <ui-menubar-content>
          <ui-menubar-group>
            <ui-menubar-item>
              New Tab <ui-menubar-shortcut>⌘T</ui-menubar-shortcut>
            </ui-menubar-item>
            <ui-menubar-item>
              New Window <ui-menubar-shortcut>⌘N</ui-menubar-shortcut>
            </ui-menubar-item>
            <ui-menubar-item data-disabled>New Incognito Window</ui-menubar-item>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-sub>
              <ui-menubar-sub-trigger>Share</ui-menubar-sub-trigger>
              <ui-menubar-sub-content>
                <ui-menubar-group>
                  <ui-menubar-item>Email link</ui-menubar-item>
                  <ui-menubar-item>Messages</ui-menubar-item>
                  <ui-menubar-item>Notes</ui-menubar-item>
                </ui-menubar-group>
              </ui-menubar-sub-content>
            </ui-menubar-sub>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-item>
              Print... <ui-menubar-shortcut>⌘P</ui-menubar-shortcut>
            </ui-menubar-item>
          </ui-menubar-group>
        </ui-menubar-content>
      </ui-menubar-menu>
      <ui-menubar-menu>
        <ui-menubar-trigger>Edit</ui-menubar-trigger>
        <ui-menubar-content>
          <ui-menubar-group>
            <ui-menubar-item>
              Undo <ui-menubar-shortcut>⌘Z</ui-menubar-shortcut>
            </ui-menubar-item>
            <ui-menubar-item>
              Redo <ui-menubar-shortcut>⇧⌘Z</ui-menubar-shortcut>
            </ui-menubar-item>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-sub>
              <ui-menubar-sub-trigger>Find</ui-menubar-sub-trigger>
              <ui-menubar-sub-content>
                <ui-menubar-group>
                  <ui-menubar-item>Search the web</ui-menubar-item>
                </ui-menubar-group>
                <ui-menubar-separator></ui-menubar-separator>
                <ui-menubar-group>
                  <ui-menubar-item>Find...</ui-menubar-item>
                  <ui-menubar-item>Find Next</ui-menubar-item>
                  <ui-menubar-item>Find Previous</ui-menubar-item>
                </ui-menubar-group>
              </ui-menubar-sub-content>
            </ui-menubar-sub>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-item>Cut</ui-menubar-item>
            <ui-menubar-item>Copy</ui-menubar-item>
            <ui-menubar-item>Paste</ui-menubar-item>
          </ui-menubar-group>
        </ui-menubar-content>
      </ui-menubar-menu>
      <ui-menubar-menu>
        <ui-menubar-trigger>View</ui-menubar-trigger>
        <ui-menubar-content class="w-44">
          <ui-menubar-group>
            <ui-menubar-item type="checkbox">Bookmarks Bar</ui-menubar-item>
            <ui-menubar-item type="checkbox" checked>Full URLs</ui-menubar-item>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-item inset>
              Reload <ui-menubar-shortcut>⌘R</ui-menubar-shortcut>
            </ui-menubar-item>
            <ui-menubar-item data-disabled inset>
              Force Reload <ui-menubar-shortcut>⇧⌘R</ui-menubar-shortcut>
            </ui-menubar-item>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-item inset>Toggle Fullscreen</ui-menubar-item>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-item inset>Hide Sidebar</ui-menubar-item>
          </ui-menubar-group>
        </ui-menubar-content>
      </ui-menubar-menu>
      <ui-menubar-menu>
        <ui-menubar-trigger>Profiles</ui-menubar-trigger>
        <ui-menubar-content>
          <ui-menubar-group>
            <ui-menubar-item type="radio" value="andy">Andy</ui-menubar-item>
            <ui-menubar-item type="radio" value="benoit" checked>Benoit</ui-menubar-item>
            <ui-menubar-item type="radio" value="Luis">Luis</ui-menubar-item>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-item inset>Edit...</ui-menubar-item>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-item inset>Add Profile...</ui-menubar-item>
          </ui-menubar-group>
        </ui-menubar-content>
      </ui-menubar-menu>
    </ui-menubar>
  `;
}
```

## Installation

```bash
npx @webjsdev/ui add menubar
```

### Copy and paste the following code into your project.

````ts title="components/ui/menubar.ts"
/**
 * Menubar: a row of menus, like a desktop application's File / Edit / View.
 * Tier-2. As in shadcn, each menu is the dropdown menu under the
 * `ui-menubar-*` tags: the same items, checkbox and radio items, labels,
 * separators, shortcuts, groups and sub-menus, with the same keyboard model
 * inside an open menu. The bar adds what a row of menus needs on top.
 *
 * shadcn parity:
 *   Menubar                  → <ui-menubar>
 *   MenubarMenu              → <ui-menubar-menu>
 *   MenubarTrigger           → <ui-menubar-trigger>File</ui-menubar-trigger> (renders the button)
 *   MenubarContent           → <ui-menubar-content side align side-offset align-offset>
 *   MenubarItem              → <ui-menubar-item> (variant, inset, type="checkbox" | "radio", checked, value)
 *   MenubarLabel / Separator / Shortcut / Group
 *                            → <ui-menubar-label> / -separator / -shortcut / -group
 *   MenubarSub / SubTrigger / SubContent
 *                            → <ui-menubar-sub> / -sub-trigger / -sub-content
 *
 * Keyboard (WAI-ARIA menubar pattern):
 *   - The bar is one Tab stop. ArrowLeft / ArrowRight move between the
 *     triggers (wrapping), Home / End go to the first / last.
 *   - ArrowDown, Enter or Space opens a trigger's menu on its first item,
 *     ArrowUp on its last.
 *   - In an open menu, ArrowLeft / ArrowRight open the neighbouring menu,
 *     unless they open or close a sub-menu. Escape closes the menu and
 *     returns focus to its trigger, Tab closes it and leaves the bar.
 *   - While a menu is open, pointing at another trigger opens that one.
 *
 * Only one menu in a bar is open at a time.
 *
 * A11y (handled by the element): the bar is `role="menubar"`, each trigger is
 * a `role="menuitem"` button carrying `aria-haspopup`, `aria-expanded` and
 * `aria-controls`, and each menu is named by its trigger. Give the bar a name
 * when the page has more than one (`aria-label` on `<ui-menubar>`).
 *
 * @example
 * ```html
 * <ui-menubar aria-label="Editor">
 *   <ui-menubar-menu>
 *     <ui-menubar-trigger>File</ui-menubar-trigger>
 *     <ui-menubar-content>
 *       <ui-menubar-item>New Tab<ui-menubar-shortcut>⌘T</ui-menubar-shortcut></ui-menubar-item>
 *       <ui-menubar-separator></ui-menubar-separator>
 *       <ui-menubar-item>Print</ui-menubar-item>
 *     </ui-menubar-content>
 *   </ui-menubar-menu>
 *   <ui-menubar-menu>
 *     <ui-menubar-trigger>View</ui-menubar-trigger>
 *     <ui-menubar-content>
 *       <ui-menubar-item type="checkbox" checked>Show Status Bar</ui-menubar-item>
 *     </ui-menubar-content>
 *   </ui-menubar-menu>
 * </ui-menubar>
 * ```
 */
import { WebComponent, html, nothing } from '@webjsdev/core';
import {
  UiDropdownMenu,
  UiDropdownMenuTrigger,
  UiDropdownMenuContent,
  UiDropdownMenuItem,
  UiDropdownMenuLabel,
  UiDropdownMenuSeparator,
  UiDropdownMenuShortcut,
  UiDropdownMenuGroup,
  UiDropdownMenuSub,
  UiDropdownMenuSubTrigger,
  UiDropdownMenuSubContent,
  type MenuClasses,
} from './dropdown-menu.ts';

/** The bar's classes (the element applies them). */
export const menubarClass = (): string =>
  'h-9 gap-1 rounded-md border bg-background p-1 shadow-xs flex items-center';
/** A trigger button's classes (the element applies them). */
export const menubarTriggerClass = (): string =>
  'rounded-sm px-2 py-1 text-sm font-medium focus:bg-accent focus:text-accent-foreground data-[state=open]:bg-accent data-[state=open]:text-accent-foreground flex items-center outline-hidden select-none';
/** A menu panel's classes (the element applies them). */
export const menubarContentClass = (): string =>
  'fixed max-h-[--available-height] min-w-[12rem] m-0 rounded-md border bg-popover p-1 text-popover-foreground shadow-md z-50 origin-(--radix-menubar-content-transform-origin) overflow-x-hidden overflow-y-auto not-open:hidden';
/** A menu item's classes (the element applies them). */
export const menubarItemClass = (): string =>
  "gap-2 rounded-sm px-2 py-1.5 text-sm focus:bg-accent focus:text-accent-foreground hover:bg-accent hover:text-accent-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50 data-[inset]:ps-8 data-[variant=destructive]:text-destructive data-[variant=destructive]:focus:bg-destructive/10 data-[variant=destructive]:focus:text-destructive data-[variant=destructive]:hover:bg-destructive/10 data-[variant=destructive]:hover:text-destructive dark:data-[variant=destructive]:focus:bg-destructive/20 dark:data-[variant=destructive]:hover:bg-destructive/20 [&_svg:not([class*='size-'])]:size-4 group/menubar-item relative flex cursor-default items-center outline-hidden select-none data-disabled:pointer-events-none [&_svg]:pointer-events-none [&_svg]:shrink-0";
/** A checkbox item's classes (the element applies them). */
export const menubarCheckboxItemClass = (): string =>
  'gap-2 rounded-sm py-1.5 pe-2 ps-8 text-sm focus:bg-accent focus:text-accent-foreground hover:bg-accent hover:text-accent-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50 data-[inset]:ps-8 relative flex cursor-default items-center outline-hidden select-none data-disabled:pointer-events-none [&_svg]:pointer-events-none [&_svg]:shrink-0';
/** A radio item's classes (the element applies them). */
export const menubarRadioItemClass = (): string =>
  'gap-2 rounded-sm py-1.5 pe-2 ps-8 text-sm focus:bg-accent focus:text-accent-foreground hover:bg-accent hover:text-accent-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50 data-[inset]:ps-8 relative flex cursor-default items-center outline-hidden select-none data-disabled:pointer-events-none [&_svg]:pointer-events-none [&_svg]:shrink-0';
/** A group label's classes. */
export const menubarLabelClass = (): string =>
  'px-2 pt-2 pb-1.5 text-xs font-semibold text-muted-foreground data-[inset]:ps-8';
/** A separator's classes. */
export const menubarSeparatorClass = (): string => '-mx-1 my-1 h-px bg-border';
/** A keyboard shortcut hint's classes. */
export const menubarShortcutClass = (): string =>
  'ms-auto text-xs tracking-widest text-muted-foreground';
/** A sub-menu trigger's classes (the element applies them). */
export const menubarSubTriggerClass = (): string =>
  "rounded-sm px-2 py-1.5 text-sm focus:bg-accent focus:text-accent-foreground hover:bg-accent hover:text-accent-foreground data-[state=open]:bg-accent data-[state=open]:text-accent-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50 data-[inset]:ps-8 [&_svg:not([class*='size-'])]:size-4 [&>svg:last-child]:ms-auto flex cursor-default items-center select-none outline-hidden [&_svg]:pointer-events-none [&_svg]:shrink-0";
/** A sub-menu panel's classes (the element applies them). */
export const menubarSubContentClass = (): string =>
  'fixed min-w-[8rem] m-0 rounded-md border bg-popover p-1 text-popover-foreground shadow-lg z-50 origin-(--radix-menubar-content-transform-origin) overflow-hidden not-open:hidden';

const menubarItemIndicatorClass = (type?: 'checkbox' | 'radio'): string =>
  type === 'radio'
    ? 'absolute start-2 flex size-3.5 items-center justify-center pointer-events-none'
    : 'absolute start-2 flex size-3.5 items-center justify-center pointer-events-none';

// The dropdown elements paint each part through this table, so every part
// carries a cn-menubar-* name, the one shadcn's styles give it.
const MENUBAR_CLASSES: MenuClasses = {
  content: menubarContentClass,
  item: menubarItemClass,
  checkboxItem: menubarCheckboxItemClass,
  radioItem: menubarRadioItemClass,
  itemIndicator: menubarItemIndicatorClass,
  label: menubarLabelClass,
  separator: menubarSeparatorClass,
  shortcut: menubarShortcutClass,
  subTrigger: menubarSubTriggerClass,
  subContent: menubarSubContentClass,
};

const FAMILY = 'ui-menubar';
const MENU = 'ui-menubar-menu';

// --------------------------------------------------------------------------
// <ui-menubar>
// --------------------------------------------------------------------------

export class UiMenubar extends WebComponent {
  render() {
    return html`<div
      data-slot="menubar"
      role="menubar"
      aria-label=${this.getAttribute?.('aria-label') ?? nothing}
      class=${menubarClass()}
      @keydown=${this._onKeyDown}
      @focusin=${this._onFocusIn}
    ><slot></slot></div>`;
  }

  connectedCallback(): void {
    super.connectedCallback?.();
    // The triggers are slotted in a pass after the first render, so the tab
    // stop is set once they are in place.
    if (typeof requestAnimationFrame === 'function') {
      requestAnimationFrame(() => this._roving());
    }
  }

  /** The menus in this bar, in order. */
  menus(): UiMenubarMenu[] {
    return Array.from(this.querySelectorAll<UiMenubarMenu>(MENU)).filter(
      (m) => m.closest(FAMILY) === this,
    );
  }

  /** The bar's open menu, if any. */
  openMenu(): UiMenubarMenu | null {
    return this.menus().find((m) => m.open) ?? null;
  }

  _buttons(): HTMLElement[] {
    return this.menus()
      .map((m) => m._triggerControl())
      .filter((b): b is HTMLElement => !!b);
  }

  // One trigger is in the tab order: the focused one, else the one that was,
  // else the first.
  _roving(current?: HTMLElement | null): void {
    const buttons = this._buttons();
    if (!buttons.length) return;
    const keep = current ?? buttons.find((b) => b.tabIndex === 0) ?? buttons[0];
    buttons.forEach((b) => { b.tabIndex = b === keep ? 0 : -1; });
  }

  _onFocusIn = (e: FocusEvent): void => {
    const button = this._buttons().find((b) => b === e.target);
    if (button) this._roving(button);
  };

  /** Open `menu`, closing whichever other menu in the bar is open. */
  switchTo(menu: UiMenubarMenu, focusLast = false): void {
    const current = this.openMenu();
    const target = menu._triggerControl();
    this._roving(target);
    if (current && current !== menu) {
      // Focus leaves the closing panel BEFORE it hides, or the engine drops
      // it to <body> (the popover="manual" rule every overlay here follows).
      target?.focus();
      current.hide();
    }
    menu._focusLastOnOpen = focusLast;
    menu.show();
  }

  // Keys on a trigger button. Keys inside an open menu are the menu's (the
  // dropdown root listens on the document while it is open).
  _onKeyDown = (e: KeyboardEvent): void => {
    const buttons = this._buttons();
    const i = buttons.indexOf(e.target as HTMLElement);
    if (i < 0) return;
    const menus = this.menus();
    const go = (j: number) => {
      e.preventDefault();
      const b = buttons[(j + buttons.length) % buttons.length];
      this._roving(b);
      b.focus();
    };
    if (e.key === 'ArrowRight') go(i + 1);
    else if (e.key === 'ArrowLeft') go(i - 1);
    else if (e.key === 'Home') go(0);
    else if (e.key === 'End') go(buttons.length - 1);
    else if (e.key === 'ArrowDown' || e.key === 'ArrowUp') {
      e.preventDefault();
      this.switchTo(menus[i], e.key === 'ArrowUp');
    }
  };
}
UiMenubar.register('ui-menubar');

// --------------------------------------------------------------------------
// <ui-menubar-menu>
// --------------------------------------------------------------------------

export class UiMenubarMenu extends UiDropdownMenu {
  static family = FAMILY;
  static rootTag = MENU;
  static classes = MENUBAR_CLASSES;
  static placement = { sideOffset: 8, alignOffset: -4 };

  // ArrowUp on a trigger opens on the LAST item.
  _focusLastOnOpen = false;

  _bar(): UiMenubar | null {
    return this.closest(FAMILY) as UiMenubar | null;
  }

  // The dropdown opens on its first item. ArrowUp asks for the last.
  _setup(): void {
    super._setup();
    if (!this._focusLastOnOpen) return;
    this._focusLastOnOpen = false;
    queueMicrotask(() => {
      const items = this.querySelectorAll<HTMLElement>(
        `${FAMILY}-content [role^="menuitem"]:not([data-disabled])`,
      );
      const own = Array.from(items).filter((it) => !it.closest(`${FAMILY}-sub-content`));
      own[own.length - 1]?.focus();
    });
  }

  // Opening one menu closes the others: one open menu per bar.
  updated(changedProperties: Map<string, unknown>): void {
    super.updated(changedProperties);
    if (!changedProperties.has('open') || !this.open) return;
    this._bar()?.menus().forEach((m) => { if (m !== this && m.open) m.hide(); });
  }

  // The dropdown wires aria-haspopup, aria-expanded and aria-controls. The
  // trigger's open styling keys on data-state, so that follows too.
  _wireAria(): void {
    super._wireAria();
    this._triggerControl()?.setAttribute('data-state', this.open ? 'open' : 'closed');
  }

  // ArrowLeft / ArrowRight the dropdown did not take (it takes them only to
  // open or close a sub-menu) move to the neighbouring menu.
  _onKeyDown(e: KeyboardEvent): void {
    super._onKeyDown(e);
    if (!this.open || e.defaultPrevented) return;
    if (e.key !== 'ArrowLeft' && e.key !== 'ArrowRight') return;
    const bar = this._bar();
    const menus = bar?.menus() ?? [];
    const i = menus.indexOf(this);
    if (!bar || i < 0 || menus.length < 2) return;
    e.preventDefault();
    const next = menus[(i + (e.key === 'ArrowRight' ? 1 : -1) + menus.length) % menus.length];
    bar.switchTo(next);
  }
}
UiMenubarMenu.register('ui-menubar-menu');

// --------------------------------------------------------------------------
// <ui-menubar-trigger>
// --------------------------------------------------------------------------

export class UiMenubarTrigger extends UiDropdownMenuTrigger {
  static family = FAMILY;
  static rootTag = MENU;
  static classes = MENUBAR_CLASSES;

  // shadcn's MenubarTrigger IS the button, so the trigger renders it, with the
  // role and the popup relationship on the element that takes focus.
  render() {
    return html`<button
      type="button"
      data-slot="menubar-trigger"
      role="menuitem"
      aria-haspopup="menu"
      aria-expanded="false"
      data-state="closed"
      class=${menubarTriggerClass()}
      @click=${this._onClick}
      @pointerenter=${this._onPointerEnter}
    ><slot></slot></button>`;
  }

  _menu(): UiMenubarMenu | null {
    return this.closest(MENU) as UiMenubarMenu | null;
  }

  _onClick = (): void => {
    const menu = this._menu();
    if (!menu) return;
    const bar = menu._bar();
    if (menu.open) menu.hide();
    else if (bar) bar.switchTo(menu);
    else menu.show();
  };

  // While one menu is open, pointing at another trigger opens that one.
  _onPointerEnter = (): void => {
    const menu = this._menu();
    const bar = menu?._bar();
    if (!menu || !bar || menu.open || !bar.openMenu()) return;
    bar.switchTo(menu);
  };
}
UiMenubarTrigger.register('ui-menubar-trigger');

export class UiMenubarContent extends UiDropdownMenuContent {
  static family = FAMILY;
  static rootTag = MENU;
  static classes = MENUBAR_CLASSES;
}
UiMenubarContent.register('ui-menubar-content');
export class UiMenubarItem extends UiDropdownMenuItem {
  static family = FAMILY;
  static rootTag = MENU;
  static classes = MENUBAR_CLASSES;
}
UiMenubarItem.register('ui-menubar-item');
export class UiMenubarLabel extends UiDropdownMenuLabel {
  static family = FAMILY;
  static rootTag = MENU;
  static classes = MENUBAR_CLASSES;
}
UiMenubarLabel.register('ui-menubar-label');
export class UiMenubarSeparator extends UiDropdownMenuSeparator {
  static family = FAMILY;
  static rootTag = MENU;
  static classes = MENUBAR_CLASSES;
}
UiMenubarSeparator.register('ui-menubar-separator');
export class UiMenubarShortcut extends UiDropdownMenuShortcut {
  static family = FAMILY;
  static rootTag = MENU;
  static classes = MENUBAR_CLASSES;
}
UiMenubarShortcut.register('ui-menubar-shortcut');
export class UiMenubarGroup extends UiDropdownMenuGroup {
  static family = FAMILY;
  static rootTag = MENU;
  static classes = MENUBAR_CLASSES;
}
UiMenubarGroup.register('ui-menubar-group');
export class UiMenubarSub extends UiDropdownMenuSub {
  static family = FAMILY;
  static rootTag = MENU;
  static classes = MENUBAR_CLASSES;
}
UiMenubarSub.register('ui-menubar-sub');
export class UiMenubarSubTrigger extends UiDropdownMenuSubTrigger {
  static family = FAMILY;
  static rootTag = MENU;
  static classes = MENUBAR_CLASSES;
}
UiMenubarSubTrigger.register('ui-menubar-sub-trigger');
export class UiMenubarSubContent extends UiDropdownMenuSubContent {
  static family = FAMILY;
  static rootTag = MENU;
  static classes = MENUBAR_CLASSES;
}
UiMenubarSubContent.register('ui-menubar-sub-content');
````

### Update the import paths to match your project setup.

## Usage

```ts
import '#components/ui/menubar.ts';
```

```ts
<ui-menubar>
  <ui-menubar-menu>
    <ui-menubar-trigger>File</ui-menubar-trigger>
    <ui-menubar-content>
      <ui-menubar-group>
        <ui-menubar-item>
          New Tab <ui-menubar-shortcut>⌘T</ui-menubar-shortcut>
        </ui-menubar-item>
        <ui-menubar-item>New Window</ui-menubar-item>
      </ui-menubar-group>
      <ui-menubar-separator></ui-menubar-separator>
      <ui-menubar-group>
        <ui-menubar-item>Share</ui-menubar-item>
        <ui-menubar-item>Print</ui-menubar-item>
      </ui-menubar-group>
    </ui-menubar-content>
  </ui-menubar-menu>
</ui-menubar>
```

## Composition

Use the following composition to build a menubar:

```text
ui-menubar
├── ui-menubar-menu
│   ├── ui-menubar-trigger
│   └── ui-menubar-content
│       ├── ui-menubar-group
│       │   ├── ui-menubar-label
│       │   ├── ui-menubar-item
│       │   └── ui-menubar-item
│       ├── ui-menubar-separator
│       ├── ui-menubar-group
│       │   ├── ui-menubar-label
│       │   ├── ui-menubar-item type="checkbox"
│       │   └── ui-menubar-item type="checkbox"
│       ├── ui-menubar-separator
│       ├── ui-menubar-group
│       │   ├── ui-menubar-label
│       │   ├── ui-menubar-item type="radio"
│       │   └── ui-menubar-item type="radio"
│       └── ui-menubar-sub
│           ├── ui-menubar-sub-trigger
│           └── ui-menubar-sub-content
│               └── ui-menubar-group
│                   ├── ui-menubar-label
│                   ├── ui-menubar-item
│                   └── ui-menubar-item
└── ui-menubar-menu
    ├── ui-menubar-trigger
    └── ui-menubar-content
        └── ui-menubar-group
            ├── ui-menubar-label
            ├── ui-menubar-item
            └── ui-menubar-item
```

## Checkbox

Use `type="checkbox"` on a `<ui-menubar-item>` for toggleable options, and `checked` for the initial state.

```ts
import { html } from '@webjsdev/core';

export default function MenubarCheckbox() {
  return html`
    <ui-menubar class="w-72">
      <ui-menubar-menu>
        <ui-menubar-trigger>View</ui-menubar-trigger>
        <ui-menubar-content class="w-64">
          <ui-menubar-item type="checkbox">Always Show Bookmarks Bar</ui-menubar-item>
          <ui-menubar-item type="checkbox" checked>
            Always Show Full URLs
          </ui-menubar-item>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-item inset>
            Reload <ui-menubar-shortcut>⌘R</ui-menubar-shortcut>
          </ui-menubar-item>
          <ui-menubar-item data-disabled inset>
            Force Reload <ui-menubar-shortcut>⇧⌘R</ui-menubar-shortcut>
          </ui-menubar-item>
        </ui-menubar-content>
      </ui-menubar-menu>
      <ui-menubar-menu>
        <ui-menubar-trigger>Format</ui-menubar-trigger>
        <ui-menubar-content>
          <ui-menubar-item type="checkbox" checked>Strikethrough</ui-menubar-item>
          <ui-menubar-item type="checkbox">Code</ui-menubar-item>
          <ui-menubar-item type="checkbox">Superscript</ui-menubar-item>
        </ui-menubar-content>
      </ui-menubar-menu>
    </ui-menubar>
  `;
}
```

## Radio

Use `type="radio"` items with a `value` inside a `<ui-menubar-group>` for single-select options. Name the set with `aria-label` on the group.

```ts
import { html } from '@webjsdev/core';

// A radio set is a labelled group of type="radio" items, and the element
// keeps one of them checked.
export default function MenubarRadio() {
  return html`
    <ui-menubar class="w-72">
      <ui-menubar-menu>
        <ui-menubar-trigger>Profiles</ui-menubar-trigger>
        <ui-menubar-content>
          <ui-menubar-group aria-label="Profiles">
            <ui-menubar-item type="radio" value="andy">Andy</ui-menubar-item>
            <ui-menubar-item type="radio" value="benoit" checked>Benoit</ui-menubar-item>
            <ui-menubar-item type="radio" value="luis">Luis</ui-menubar-item>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-item inset>Edit...</ui-menubar-item>
          <ui-menubar-item inset>Add Profile...</ui-menubar-item>
        </ui-menubar-content>
      </ui-menubar-menu>
      <ui-menubar-menu>
        <ui-menubar-trigger>Theme</ui-menubar-trigger>
        <ui-menubar-content>
          <ui-menubar-group aria-label="Theme">
            <ui-menubar-item type="radio" value="light">Light</ui-menubar-item>
            <ui-menubar-item type="radio" value="dark">Dark</ui-menubar-item>
            <ui-menubar-item type="radio" value="system" checked>System</ui-menubar-item>
          </ui-menubar-group>
        </ui-menubar-content>
      </ui-menubar-menu>
    </ui-menubar>
  `;
}
```

## Submenu

Use `<ui-menubar-sub>`, `<ui-menubar-sub-trigger>`, and `<ui-menubar-sub-content>` for nested menus.

```ts
import { html } from '@webjsdev/core';

export default function MenubarSubmenu() {
  return html`
    <ui-menubar class="w-72">
      <ui-menubar-menu>
        <ui-menubar-trigger>File</ui-menubar-trigger>
        <ui-menubar-content>
          <ui-menubar-sub>
            <ui-menubar-sub-trigger>Share</ui-menubar-sub-trigger>
            <ui-menubar-sub-content>
              <ui-menubar-item>Email link</ui-menubar-item>
              <ui-menubar-item>Messages</ui-menubar-item>
              <ui-menubar-item>Notes</ui-menubar-item>
            </ui-menubar-sub-content>
          </ui-menubar-sub>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-item>
            Print... <ui-menubar-shortcut>⌘P</ui-menubar-shortcut>
          </ui-menubar-item>
        </ui-menubar-content>
      </ui-menubar-menu>
      <ui-menubar-menu>
        <ui-menubar-trigger>Edit</ui-menubar-trigger>
        <ui-menubar-content>
          <ui-menubar-item>
            Undo <ui-menubar-shortcut>⌘Z</ui-menubar-shortcut>
          </ui-menubar-item>
          <ui-menubar-item>
            Redo <ui-menubar-shortcut>⇧⌘Z</ui-menubar-shortcut>
          </ui-menubar-item>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-sub>
            <ui-menubar-sub-trigger>Find</ui-menubar-sub-trigger>
            <ui-menubar-sub-content>
              <ui-menubar-item>Find...</ui-menubar-item>
              <ui-menubar-item>Find Next</ui-menubar-item>
              <ui-menubar-item>Find Previous</ui-menubar-item>
            </ui-menubar-sub-content>
          </ui-menubar-sub>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-item>Cut</ui-menubar-item>
          <ui-menubar-item>Copy</ui-menubar-item>
          <ui-menubar-item>Paste</ui-menubar-item>
        </ui-menubar-content>
      </ui-menubar-menu>
    </ui-menubar>
  `;
}
```

## With Icons

```ts
import { html } from '@webjsdev/core';
import {
  FileIcon, FolderIcon, HelpCircleIcon, SaveIcon, SettingsIcon, TrashIcon,
} from '#lib/ui/lucide.ts';

export default function MenubarIcons() {
  return html`
    <ui-menubar class="w-72">
      <ui-menubar-menu>
        <ui-menubar-trigger>File</ui-menubar-trigger>
        <ui-menubar-content>
          <ui-menubar-item>
            ${FileIcon()}
            New File <ui-menubar-shortcut>⌘N</ui-menubar-shortcut>
          </ui-menubar-item>
          <ui-menubar-item>
            ${FolderIcon()}
            Open Folder
          </ui-menubar-item>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-item>
            ${SaveIcon()}
            Save <ui-menubar-shortcut>⌘S</ui-menubar-shortcut>
          </ui-menubar-item>
        </ui-menubar-content>
      </ui-menubar-menu>
      <ui-menubar-menu>
        <ui-menubar-trigger>More</ui-menubar-trigger>
        <ui-menubar-content>
          <ui-menubar-group>
            <ui-menubar-item>
              ${SettingsIcon()}
              Settings
            </ui-menubar-item>
            <ui-menubar-item>
              ${HelpCircleIcon()}
              Help
            </ui-menubar-item>
            <ui-menubar-separator></ui-menubar-separator>
            <ui-menubar-item variant="destructive">
              ${TrashIcon()}
              Delete
            </ui-menubar-item>
          </ui-menubar-group>
        </ui-menubar-content>
      </ui-menubar-menu>
    </ui-menubar>
  `;
}
```

## RTL

To enable RTL support, see the [RTL configuration guide](https://webjs.dev/ui/docs/rtl).

```ts
import { html } from '@webjsdev/core';

const translations = {
  en: {
    dir: 'ltr',
    values: {
      file: 'File',
      newTab: 'New Tab',
      newWindow: 'New Window',
      newIncognitoWindow: 'New Incognito Window',
      share: 'Share',
      emailLink: 'Email link',
      messages: 'Messages',
      notes: 'Notes',
      print: 'Print...',
      edit: 'Edit',
      undo: 'Undo',
      redo: 'Redo',
      find: 'Find',
      searchTheWeb: 'Search the web',
      findItem: 'Find...',
      findNext: 'Find Next',
      findPrevious: 'Find Previous',
      cut: 'Cut',
      copy: 'Copy',
      paste: 'Paste',
      view: 'View',
      bookmarksBar: 'Bookmarks Bar',
      fullUrls: 'Full URLs',
      reload: 'Reload',
      forceReload: 'Force Reload',
      toggleFullscreen: 'Toggle Fullscreen',
      hideSidebar: 'Hide Sidebar',
      profiles: 'Profiles',
      andy: 'Andy',
      benoit: 'Benoit',
      luis: 'Luis',
      editProfile: 'Edit...',
      addProfile: 'Add Profile...',
    },
  },
  ar: {
    dir: 'rtl',
    values: {
      file: 'ملف',
      newTab: 'علامة تبويب جديدة',
      newWindow: 'نافذة جديدة',
      newIncognitoWindow: 'نافذة التصفح المتخفي الجديدة',
      share: 'مشاركة',
      emailLink: 'رابط البريد الإلكتروني',
      messages: 'الرسائل',
      notes: 'الملاحظات',
      print: 'طباعة...',
      edit: 'تعديل',
      undo: 'تراجع',
      redo: 'إعادة',
      find: 'بحث',
      searchTheWeb: 'البحث على الويب',
      findItem: 'بحث...',
      findNext: 'البحث التالي',
      findPrevious: 'البحث السابق',
      cut: 'قص',
      copy: 'نسخ',
      paste: 'لصق',
      view: 'عرض',
      bookmarksBar: 'شريط الإشارات المرجعية',
      fullUrls: 'عناوين URL الكاملة',
      reload: 'إعادة تحميل',
      forceReload: 'إعادة تحميل قسري',
      toggleFullscreen: 'تبديل وضع ملء الشاشة',
      hideSidebar: 'إخفاء الشريط الجانبي',
      profiles: 'الملفات الشخصية',
      andy: 'Andy',
      benoit: 'Benoit',
      luis: 'Luis',
      editProfile: 'تعديل...',
      addProfile: 'إضافة ملف شخصي...',
    },
  },
  he: {
    dir: 'rtl',
    values: {
      file: 'קובץ',
      newTab: 'כרטיסייה חדשה',
      newWindow: 'חלון חדש',
      newIncognitoWindow: 'חלון גלישה בסתר חדש',
      share: 'שתף',
      emailLink: 'קישור אימייל',
      messages: 'הודעות',
      notes: 'הערות',
      print: 'הדפס...',
      edit: 'ערוך',
      undo: 'בטל',
      redo: 'בצע שוב',
      find: 'מצא',
      searchTheWeb: 'חפש באינטרנט',
      findItem: 'מצא...',
      findNext: 'מצא הבא',
      findPrevious: 'מצא הקודם',
      cut: 'גזור',
      copy: 'העתק',
      paste: 'הדבק',
      view: 'תצוגה',
      bookmarksBar: 'סרגל סימניות',
      fullUrls: 'כתובות URL מלאות',
      reload: 'רענן',
      forceReload: 'רענן בכוח',
      toggleFullscreen: 'החלף מסך מלא',
      hideSidebar: 'הסתר סרגל צד',
      profiles: 'פרופילים',
      andy: 'Andy',
      benoit: 'Benoit',
      luis: 'Luis',
      editProfile: 'ערוך...',
      addProfile: 'הוסף פרופיל...',
    },
  },
};

// The provider is the dir attribute: the menus open in the top layer but stay
// in the document, so they inherit dir="rtl" from the bar.
export default function MenubarRtl() {
  const lang = 'ar';
  const { dir, values: t } = translations[lang];

  return html`
    <ui-menubar class="w-72" dir=${dir} lang=${lang}>
      <ui-menubar-menu>
        <ui-menubar-trigger>${t.file}</ui-menubar-trigger>
        <ui-menubar-content>
          <ui-menubar-group>
            <ui-menubar-item>
              ${t.newTab} <ui-menubar-shortcut>⌘T</ui-menubar-shortcut>
            </ui-menubar-item>
            <ui-menubar-item>
              ${t.newWindow} <ui-menubar-shortcut>⌘N</ui-menubar-shortcut>
            </ui-menubar-item>
            <ui-menubar-item data-disabled>${t.newIncognitoWindow}</ui-menubar-item>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-sub>
              <ui-menubar-sub-trigger>${t.share}</ui-menubar-sub-trigger>
              <ui-menubar-sub-content>
                <ui-menubar-group>
                  <ui-menubar-item>${t.emailLink}</ui-menubar-item>
                  <ui-menubar-item>${t.messages}</ui-menubar-item>
                  <ui-menubar-item>${t.notes}</ui-menubar-item>
                </ui-menubar-group>
              </ui-menubar-sub-content>
            </ui-menubar-sub>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-item>
              ${t.print} <ui-menubar-shortcut>⌘P</ui-menubar-shortcut>
            </ui-menubar-item>
          </ui-menubar-group>
        </ui-menubar-content>
      </ui-menubar-menu>
      <ui-menubar-menu>
        <ui-menubar-trigger>${t.edit}</ui-menubar-trigger>
        <ui-menubar-content>
          <ui-menubar-group>
            <ui-menubar-item>
              ${t.undo} <ui-menubar-shortcut>⌘Z</ui-menubar-shortcut>
            </ui-menubar-item>
            <ui-menubar-item>
              ${t.redo} <ui-menubar-shortcut>⇧⌘Z</ui-menubar-shortcut>
            </ui-menubar-item>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-sub>
              <ui-menubar-sub-trigger>${t.find}</ui-menubar-sub-trigger>
              <ui-menubar-sub-content>
                <ui-menubar-group>
                  <ui-menubar-item>${t.searchTheWeb}</ui-menubar-item>
                </ui-menubar-group>
                <ui-menubar-separator></ui-menubar-separator>
                <ui-menubar-group>
                  <ui-menubar-item>${t.findItem}</ui-menubar-item>
                  <ui-menubar-item>${t.findNext}</ui-menubar-item>
                  <ui-menubar-item>${t.findPrevious}</ui-menubar-item>
                </ui-menubar-group>
              </ui-menubar-sub-content>
            </ui-menubar-sub>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-item>${t.cut}</ui-menubar-item>
            <ui-menubar-item>${t.copy}</ui-menubar-item>
            <ui-menubar-item>${t.paste}</ui-menubar-item>
          </ui-menubar-group>
        </ui-menubar-content>
      </ui-menubar-menu>
      <ui-menubar-menu>
        <ui-menubar-trigger>${t.view}</ui-menubar-trigger>
        <ui-menubar-content class="w-44">
          <ui-menubar-group>
            <ui-menubar-item type="checkbox">${t.bookmarksBar}</ui-menubar-item>
            <ui-menubar-item type="checkbox" checked>${t.fullUrls}</ui-menubar-item>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-item inset>
              ${t.reload} <ui-menubar-shortcut>⌘R</ui-menubar-shortcut>
            </ui-menubar-item>
            <ui-menubar-item data-disabled inset>
              ${t.forceReload} <ui-menubar-shortcut>⇧⌘R</ui-menubar-shortcut>
            </ui-menubar-item>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-item inset>${t.toggleFullscreen}</ui-menubar-item>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-item inset>${t.hideSidebar}</ui-menubar-item>
          </ui-menubar-group>
        </ui-menubar-content>
      </ui-menubar-menu>
      <ui-menubar-menu>
        <ui-menubar-trigger>${t.profiles}</ui-menubar-trigger>
        <ui-menubar-content>
          <ui-menubar-group aria-label=${t.profiles}>
            <ui-menubar-item type="radio" value="andy">${t.andy}</ui-menubar-item>
            <ui-menubar-item type="radio" value="benoit" checked>${t.benoit}</ui-menubar-item>
            <ui-menubar-item type="radio" value="Luis">${t.luis}</ui-menubar-item>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-item inset>${t.editProfile}</ui-menubar-item>
          </ui-menubar-group>
          <ui-menubar-separator></ui-menubar-separator>
          <ui-menubar-group>
            <ui-menubar-item inset>${t.addProfile}</ui-menubar-item>
          </ui-menubar-group>
        </ui-menubar-content>
      </ui-menubar-menu>
    </ui-menubar>
  `;
}
```

## API Reference

The menubar is a row of dropdown menus. Each menu takes the same parts as the [Dropdown Menu](https://webjs.dev/ui/docs/components/dropdown-menu), under `ui-menubar-*` tags, and the bar adds the keyboard model of the WAI-ARIA menubar pattern on top: the bar is one Tab stop, ArrowLeft and ArrowRight move between the triggers and between open menus, and only one menu is open at a time.

### Elements

| Element | Description |
| --- | --- |
| `<ui-menubar>` | The bar, `role="menubar"`. Give it an `aria-label` when the page has more than one. |
| `<ui-menubar-menu>` | One menu: a trigger and its content. |
| `<ui-menubar-trigger>` | The button that opens the menu, with `aria-haspopup`, `aria-expanded` and `aria-controls` set by the element. |
| `<ui-menubar-content>` | The menu panel, `role="menu"`, named by its trigger. |
| `<ui-menubar-item>` | An item. A plain action, a checkbox item, or a radio item. |
| `<ui-menubar-group>` | Groups items. Wraps a radio set, named with `aria-label`. |
| `<ui-menubar-label>` | A group heading. |
| `<ui-menubar-separator>` | A divider between groups. |
| `<ui-menubar-shortcut>` | A keyboard shortcut hint at the end of an item. |
| `<ui-menubar-sub>`, `<ui-menubar-sub-trigger>`, `<ui-menubar-sub-content>` | A nested menu, its trigger item, and its panel. |

### ui-menubar-content

| Attribute | Type | Default |
| --- | --- | --- |
| `side` | `"top" \| "right" \| "bottom" \| "left"` | `"bottom"` |
| `align` | `"start" \| "center" \| "end"` | `"start"` |
| `side-offset` | `number` | `8` |
| `align-offset` | `number` | `-4` |

### ui-menubar-item

| Attribute | Type | Default |
| --- | --- | --- |
| `variant` | `"default" \| "destructive"` | `"default"` |
| `inset` | `boolean` | `false` |
| `type` | `"checkbox" \| "radio"` | none |
| `checked` | `boolean` | `false` |
| `value` | `string` | none |
| `data-disabled` | `boolean` | `false` |

Activating an item dispatches a bubbling, cancelable `ui-item-select` event with `{ value, item, type, checked }` in its `detail`. Call `preventDefault()` on it to keep the menu open.
