Playground

Dropdown menu

A list of actions that opens from a button.

  • Built on native ARIA (shared positioning)
  • 10 parts, named exports
  • role=menu with menuitem, menuitemcheckbox and menuitemradio items.
  • Arrow keys move, Enter and Space activate, Escape closes and returns focus, type-ahead jumps to an item.
  • The trigger has aria-haspopup and aria-expanded.
  • Styles in one file: popover.css

Import

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

Not installed yet? Pick a route.

Copies the source and its styles into your project.

npx monoline add dropdown-menu

Usage

import {Button, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger} from '@monoline/react';

<DropdownMenu>
  <DropdownMenuTrigger asChild><Button variant="line">Actions</Button></DropdownMenuTrigger>
  <DropdownMenuContent>
    <DropdownMenuLabel>Entry</DropdownMenuLabel>
    <DropdownMenuItem>Rename</DropdownMenuItem>
    <DropdownMenuItem>Duplicate</DropdownMenuItem>
    <DropdownMenuSeparator />
    <DropdownMenuItem tone="danger">Delete</DropdownMenuItem>
  </DropdownMenuContent>
</DropdownMenu>

Anatomy

Import the parts you need and nest them like this.

import {DropdownMenu, DropdownMenuTrigger, DropdownMenuGroup, DropdownMenuRadioGroup, DropdownMenuContent, DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioItem, DropdownMenuLabel, DropdownMenuSeparator} from '@monoline/react';

<DropdownMenu>
  <DropdownMenuTrigger />
  <DropdownMenuGroup />
  <DropdownMenuRadioGroup />
  <DropdownMenuContent />
  <DropdownMenuItem />
  <DropdownMenuCheckboxItem />
  <DropdownMenuRadioItem />
  <DropdownMenuLabel />
  <DropdownMenuSeparator />
</DropdownMenu>

Examples

Actions

Props

DropdownMenuItemProps

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

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

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=menu with menuitem, menuitemcheckbox and menuitemradio items.
  • Arrow keys move, Enter and Space activate, Escape closes and returns focus, type-ahead jumps to an item.
  • The trigger has aria-haspopup and aria-expanded.

Keyboard

KeysAction
Arrow keysMove
Enter / SpaceActivate
EscapeCloses and returns focus, type-ahead jumps to an item