A visually persistent menu common in desktop applications that provides quick access to a consistent set of commands.
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>
`;
}
View Code
Installation
Copy and paste the following code into your project.
/**
* 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
import '#components/ui/menubar.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:
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.
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>
`;
}
View Code
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.
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>
`;
}
View Code
Submenu
Use <ui-menubar-sub>, <ui-menubar-sub-trigger>, and <ui-menubar-sub-content> for nested menus.
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>
`;
}
View Code
With Icons
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>
`;
}
View Code
RTL
To enable RTL support, see the RTL configuration guide.
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>
`;
}
View Code
API Reference
The menubar is a row of dropdown menus. Each menu takes the same parts as the 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
ui-menubar-content
ui-menubar-item
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.