Context Menu
A menu triggered by right-click. Uses the Popover API with contextmenu event.
Default
<div class="context-menu-trigger" data-context-menu="edit-menu" tabindex="0"
aria-haspopup="menu" aria-expanded="false" aria-controls="edit-menu">
Right click or press Shift+F10
</div>
<div class="context-menu" id="edit-menu" role="menu" aria-label="Editing actions" popover>
<button type="button" class="context-menu-item" role="menuitem" tabindex="-1">Cut</button>
<button type="button" class="context-menu-item" role="menuitem" tabindex="-1" disabled>Paste</button>
<div class="context-menu-separator" role="separator"></div>
<button type="button" class="context-menu-item" role="menuitem" tabindex="-1"
data-variant="destructive">Delete</button>
</div>
CSS view file
Styles for the context-menu component. Uses design tokens for colors, spacing, and radius.
@layer components {
.context-menu-trigger {
display: flex;
align-items: center;
justify-content: center;
border: 1px dashed var(--border);
border-radius: var(--radius-lg);
padding: 3rem;
font-size: 0.875rem;
color: var(--muted-foreground);
cursor: default;
&:focus-visible { outline: 2px solid var(--ring); outline-offset: 2px; }
}
.context-menu {
position: fixed;
inset: var(--menu-y, auto) auto auto var(--menu-x, auto);
margin: 0;
box-sizing: border-box;
border: none;
border-radius: var(--radius-lg);
background-color: var(--popover);
color: var(--popover-foreground);
padding: 0.25rem;
min-width: min(9rem, calc(100dvw - 1rem));
width: max-content;
max-width: calc(100dvw - 1rem);
max-height: calc(100dvh - 1rem);
overflow: auto;
overscroll-behavior: contain;
box-shadow: var(--shadow-md), 0 0 0 1px color-mix(in oklch, var(--foreground) 10%, transparent);
opacity: 0;
transition: opacity 100ms ease, display 100ms allow-discrete, overlay 100ms allow-discrete;
&[data-dropdown-panel="submenu"] { min-width: min(6rem, calc(100dvw - 1rem)); }
&:popover-open { opacity: 1; }
}
@starting-style {
.context-menu:popover-open { opacity: 0; }
}
.context-menu-item {
display: flex;
align-items: center;
gap: 0.375rem;
box-sizing: border-box;
width: 100%;
padding: 0.25rem 0.375rem;
border: none;
border-radius: var(--radius-md);
outline: none;
background: transparent;
color: var(--popover-foreground);
font: inherit;
font-size: 0.875rem;
line-height: 1.25rem;
text-align: start;
cursor: default;
user-select: none;
&[data-inset] { padding-inline-start: 1.75rem; }
& > svg { width: 1rem; height: 1rem; flex-shrink: 0; pointer-events: none; }
&:is(:focus, [data-highlighted], [aria-expanded="true"]) {
background-color: var(--accent);
color: var(--accent-foreground);
}
&[data-variant="destructive"] {
color: var(--destructive);
&:is(:focus, [data-highlighted]) { background: color-mix(in oklch, var(--destructive) 10%, transparent); }
}
&:is(:disabled, [aria-disabled="true"], [data-disabled]) {
opacity: 0.5;
pointer-events: none;
}
}
.dark .context-menu-item[data-variant="destructive"]:is(:focus, [data-highlighted]) {
background: color-mix(in oklch, var(--destructive) 20%, transparent);
}
.context-menu-item[data-dropdown-submenu]::after {
content: '';
margin-inline-start: auto;
width: 0.375rem;
height: 0.375rem;
border-block-start: 1px solid currentColor;
border-inline-end: 1px solid currentColor;
rotate: 45deg;
}
.context-menu-item[data-dropdown-submenu]:dir(rtl)::after { rotate: -45deg; }
.context-menu-item:is([role="menuitemcheckbox"], [role="menuitemradio"]) {
position: relative;
padding-inline-end: 2rem;
}
.context-menu-item[aria-checked="true"]::before {
content: '';
position: absolute;
inset-inline-end: 0.625rem;
top: 50%;
translate: 0 -60%;
width: 0.375rem;
height: 0.625rem;
border: solid currentColor;
border-width: 0 2px 2px 0;
rotate: 45deg;
}
.context-menu-label {
padding: 0.25rem 0.375rem;
font-size: 0.75rem;
font-weight: 500;
color: var(--muted-foreground);
}
.context-menu-shortcut {
margin-inline-start: auto;
font-size: 0.75rem;
letter-spacing: 0.05em;
color: var(--muted-foreground);
}
.context-menu-separator {
height: 1px;
background-color: var(--border);
margin: 0.25rem -0.25rem;
}
@media (prefers-reduced-motion: reduce) {
.context-menu { transition: none; }
}
@media (forced-colors: active) {
.context-menu { outline: 1px solid CanvasText; }
.context-menu-item:is(:focus, [data-highlighted]) {
forced-color-adjust: none;
background-color: Highlight;
color: HighlightText;
}
}
}
JavaScript view file
Right-click or use Shift+F10 or the Context Menu key. The component shares positioning, keyboard navigation, and dismissal behavior with Dropdown Menu.
import { openMenu } from '../dropdown/dropdown.js';
let openingPointer = null;
let pendingOpen = null;
document.addEventListener('pointerdown', event => {
if (event.button === 2 || (event.button === 0 && event.ctrlKey)) {
openingPointer = event.pointerId;
}
}, true);
function finishOpeningPointer(event) {
if (event.pointerId !== openingPointer) return;
openingPointer = null;
if (!pendingOpen) return;
setTimeout(pendingOpen, 0);
pendingOpen = null;
}
document.addEventListener('pointerup', finishOpeningPointer, true);
document.addEventListener('pointercancel', finishOpeningPointer, true);
function contextTarget(event) {
const trigger = event.target instanceof Element && event.target.closest('[data-context-menu]');
if (!trigger) return null;
const menu = document.getElementById(trigger.dataset.contextMenu);
if (!menu?.hasAttribute('popover')) return null;
if (!menu.hasAttribute('role')) menu.setAttribute('role', 'menu');
return { trigger, menu };
}
document.addEventListener('contextmenu', event => {
if (event.defaultPrevented) return;
const target = contextTarget(event);
if (!target) return;
event.preventDefault();
const point = { x: event.clientX, y: event.clientY };
const open = () => {
if (target.trigger.isConnected && target.menu.isConnected) {
openMenu(target.menu, target.trigger, { point });
}
};
// Some browsers dispatch contextmenu before pointerup. Wait for that gesture
// to end so native light dismissal does not immediately close the new menu.
if (openingPointer !== null) pendingOpen = open;
else setTimeout(open, 0);
});
document.addEventListener('keydown', event => {
if (event.defaultPrevented || event.isComposing) return;
if (event.key !== 'ContextMenu' && !(event.shiftKey && event.key === 'F10')) return;
const target = contextTarget(event);
if (!target) return;
event.preventDefault();
const anchor = target.trigger.getBoundingClientRect();
const x = getComputedStyle(target.trigger).direction === 'rtl' ? anchor.right : anchor.left;
openMenu(target.menu, target.trigger, { point: { x, y: anchor.bottom } });
});