Playground

Menubar

A horizontal bar of menus, like File, Edit and View in a desktop app.

  • Built on native ARIA (shared positioning)
  • 7 parts, named exports
  • role="menubar"; arrow keys move between menus and items, Enter or Space opens.
  • Escape closes the open menu and returns focus to its trigger.
  • Styles in one file: popover.css

Import

import '@monoline/css';
import {Menubar} from '@monoline/react';

Not installed yet? Pick a route.

Copies the source and its styles into your project.

npx monoline add menubar

Usage

import {Menubar, MenubarContent, MenubarItem, MenubarMenu, MenubarSeparator, MenubarTrigger} from '@monoline/react';

<Menubar aria-label="Application">
  <MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>New file</MenubarItem><MenubarItem>Open</MenubarItem><MenubarSeparator /><MenubarItem>Quit</MenubarItem></MenubarContent></MenubarMenu>
  <MenubarMenu><MenubarTrigger>Edit</MenubarTrigger><MenubarContent><MenubarItem>Undo</MenubarItem><MenubarItem>Redo</MenubarItem></MenubarContent></MenubarMenu>
</Menubar>

Anatomy

Import the parts you need and nest them like this.

import {Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem, MenubarLabel, MenubarSeparator} from '@monoline/react';

<Menubar>
  <MenubarMenu />
  <MenubarTrigger />
  <MenubarContent />
  <MenubarItem />
  <MenubarLabel />
  <MenubarSeparator />
</Menubar>

Examples

App menu

Props

MenubarItemProps

PropTypeDefaultDescription
tone"danger" | "default"'default'`danger` highlights in the danger colour.

Data Attributes

State is exposed through attributes. Style it with these selectors, not with class toggles.

AttributeStylesheet
[data-disabled]popover.css
[data-highlighted]popover.css
[data-variant="danger"]popover.css
[data-highlighted]menubar.css
[data-state="open"]menubar.css

CSS classes

ClassStylesheet
.menu-contentpopover.css
.menu-indicatorpopover.css
.menu-itempopover.css
.menu-item-checkpopover.css
.menu-labelpopover.css
.popoverpopover.css
.danger17-dropdown-menu.css
.dropdown17-dropdown-menu.css
.menu17-dropdown-menu.css
.menu-end17-dropdown-menu.css
.menu-item17-dropdown-menu.css
.menu-sep17-dropdown-menu.css
.menubarmenubar.css
.menubar-triggermenubar.css

Customization

Style it with the kit's tokens in your own CSS, loaded after @monoline/css. Prefer the attributes above over extra classes. See Theming for every token.

app.css
.menu-content {
  border-color: var(--accent);
}
.menu-content[data-disabled] {
  background: var(--wash);
}

Accessibility

  • role="menubar"; arrow keys move between menus and items, Enter or Space opens.
  • Escape closes the open menu and returns focus to its trigger.

Keyboard

KeysAction
Arrow keysMove between menus and items
Enter / SpaceOpens
EscapeCloses the open menu and returns focus to its trigger