Context menu
A menu of actions opened by right click or long press on an area.
SourceStyles source@monoline/react 0.4.0Markdown for AI toolsstable
- Built on native ARIA (shared positioning)
- 6 parts, named exports
- Opens with right click, long press or the context-menu key (Shift+F10).
- Arrow keys move, Enter or Space selects, Escape closes and returns focus.
- Every action must also exist elsewhere in the UI for people who cannot open it.
- Styles in one file:
popover.css
Import
import '@monoline/css';
import {ContextMenu} from '@monoline/react';
Not installed yet? Pick a route.
Copies the source and its styles into your project.
npx monoline add context-menu
Usage
import {ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuLabel, ContextMenuSeparator, ContextMenuTrigger} from '@monoline/react';
<ContextMenu>
<ContextMenuTrigger><div style={{display: 'grid', placeItems: 'center', height: '120px', border: '1px dashed var(--rule)'}}>Right click here</div></ContextMenuTrigger>
<ContextMenuContent aria-label="File actions"><ContextMenuLabel>File</ContextMenuLabel><ContextMenuItem>Rename</ContextMenuItem><ContextMenuItem>Duplicate</ContextMenuItem><ContextMenuSeparator /><ContextMenuItem tone="danger">Delete</ContextMenuItem></ContextMenuContent>
</ContextMenu>
Anatomy
Import the parts you need and nest them like this.
import {ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuLabel, ContextMenuSeparator} from '@monoline/react';
<ContextMenu>
<ContextMenuTrigger />
<ContextMenuContent />
<ContextMenuItem />
<ContextMenuLabel />
<ContextMenuSeparator />
</ContextMenu>
Examples
Right click the box
Props
ContextMenuItemProps
| 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
- Opens with right click, long press or the context-menu key (Shift+F10).
- Arrow keys move, Enter or Space selects, Escape closes and returns focus.
- Every action must also exist elsewhere in the UI for people who cannot open it.
Keyboard
| Keys | Action |
|---|---|
| Arrow keys | Move |
| Enter / Space | Selects |
| Escape | Closes and returns focus |