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 } });
});