Dropdown menu
A list of actions that opens from a button.
SourceStyles source@monoline/react 0.5.0Markdown for AI toolsstable
- 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
| Prop | Type | Default | Description |
|---|---|---|---|
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.
| Attribute | Stylesheet |
|---|---|
[data-disabled] | popover.css |
[data-highlighted] | popover.css |
[data-variant="danger"] | popover.css |
CSS classes
| Class | Stylesheet |
|---|---|
.menu-content | popover.css |
.menu-indicator | popover.css |
.menu-item | popover.css |
.menu-item-check | popover.css |
.menu-label | popover.css |
.popover | popover.css |
.danger | 17-dropdown-menu.css |
.dropdown | 17-dropdown-menu.css |
.menu | 17-dropdown-menu.css |
.menu-end | 17-dropdown-menu.css |
.menu-item | 17-dropdown-menu.css |
.menu-sep | 17-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
| Keys | Action |
|---|---|
| Arrow keys | Move |
| Enter / Space | Activate |
| Escape | Closes and returns focus, type-ahead jumps to an item |