Standard Menu

Full-featured menu with icons, keyboard shortcuts, groups, separators, a disabled item, and a destructive action.

<!-- Trigger -->
<button class="btn" data-variant="default"
        aria-haspopup="menu" aria-expanded="false"
        aria-controls="demo-dropdown"
        data-dropdown-trigger="demo-dropdown">
  Options
  <svg aria-hidden="true" width="14" height="14" viewBox="0 0 24 24"
       fill="none" stroke="currentColor" stroke-width="2">
    <path d="m6 9 6 6 6-6"/>
  </svg>
</button>

<!-- Menu -->
<div id="demo-dropdown" role="menu" popover
     class="dropdown-content" aria-label="Options menu"
     style="min-width:12rem;">
  <div class="dropdown-label">My Account</div>
  <div role="group" aria-label="Navigation">
    <button role="menuitem" class="dropdown-item" tabindex="-1">
      <svg aria-hidden="true" width="14" height="14">&hellip;</svg>
      Profile
      <span class="dropdown-shortcut">⇧⌘P</span>
    </button>
    <button role="menuitem" class="dropdown-item" tabindex="-1">
      <svg aria-hidden="true" width="14" height="14">&hellip;</svg>
      Settings
      <span class="dropdown-shortcut">⌘S</span>
    </button>
    <button role="menuitem" class="dropdown-item"
            tabindex="-1" disabled>
      <svg aria-hidden="true" width="14" height="14">&hellip;</svg>
      Upload
      <span class="dropdown-shortcut">⌘U</span>
    </button>
  </div>
  <div class="dropdown-separator" role="separator"></div>
  <div role="group" aria-label="Actions">
    <button role="menuitem" class="dropdown-item" tabindex="-1">
      <svg aria-hidden="true" width="14" height="14">&hellip;</svg>
      Export
      <span class="dropdown-shortcut">⌘E</span>
    </button>
    <button role="menuitem" class="dropdown-item"
            data-variant="destructive" tabindex="-1">
      <svg aria-hidden="true" width="14" height="14">&hellip;</svg>
      Delete
      <span class="dropdown-shortcut">⌘⌫</span>
    </button>
  </div>
</div>

Checkbox & Radio

Use menuitemcheckbox for toggleable options and menuitemradio inside a role="group" for exclusive choices.

<!-- Trigger -->
<button class="btn" data-variant="outline"
        aria-haspopup="menu" aria-expanded="false"
        aria-controls="demo-dropdown-checks"
        data-dropdown-trigger="demo-dropdown-checks">
  View
  <svg aria-hidden="true" width="14" height="14" viewBox="0 0 24 24"
       fill="none" stroke="currentColor" stroke-width="2">
    <path d="m6 9 6 6 6-6"/>
  </svg>
</button>

<!-- Checkbox / Radio Menu -->
<div id="demo-dropdown-checks" role="menu" popover
     class="dropdown-content" aria-label="View options"
     style="min-width:11rem;">
  <div class="dropdown-label">Appearance</div>
  <div role="group" aria-label="Toggle columns">
    <button role="menuitemcheckbox"
            class="dropdown-item dropdown-check"
            aria-checked="true" tabindex="-1">Status Bar</button>
    <button role="menuitemcheckbox"
            class="dropdown-item dropdown-check"
            aria-checked="false" tabindex="-1">Activity Bar</button>
    <button role="menuitemcheckbox"
            class="dropdown-item dropdown-check"
            aria-checked="true" tabindex="-1">Panel</button>
  </div>
  <div class="dropdown-separator" role="separator"></div>
  <div class="dropdown-label">Layout</div>
  <div role="group" aria-label="Layout style">
    <button role="menuitemradio"
            class="dropdown-item dropdown-radio"
            aria-checked="true" tabindex="-1">Sidebar Left</button>
    <button role="menuitemradio"
            class="dropdown-item dropdown-radio"
            aria-checked="false" tabindex="-1">Sidebar Right</button>
  </div>
</div>

Trigger Variants

Any button variant can serve as a dropdown trigger. Here a secondary button and a ghost icon-only button open simple menus.

<!-- Secondary trigger -->
<button class="btn" data-variant="secondary"
        aria-haspopup="menu" aria-expanded="false"
        aria-controls="demo-dropdown-3"
        data-dropdown-trigger="demo-dropdown-3">
  More
  <svg aria-hidden="true" width="14" height="14" viewBox="0 0 24 24"
       fill="none" stroke="currentColor" stroke-width="2">
    <path d="m6 9 6 6 6-6"/>
  </svg>
</button>

<div id="demo-dropdown-3" role="menu" popover
     class="dropdown-content" aria-label="More options"
     style="min-width:10rem;">
  <button role="menuitem" class="dropdown-item" tabindex="-1">Copy</button>
  <button role="menuitem" class="dropdown-item" tabindex="-1">Paste</button>
  <div class="dropdown-separator" role="separator"></div>
  <button role="menuitem" class="dropdown-item" tabindex="-1">Select All</button>
</div>

<!-- Ghost icon trigger -->
<button class="btn" data-variant="ghost" data-size="icon"
        aria-haspopup="menu" aria-expanded="false"
        aria-controls="demo-dropdown-4"
        data-dropdown-trigger="demo-dropdown-4"
        aria-label="More options">
  <svg aria-hidden="true" width="16" height="16" viewBox="0 0 24 24"
       fill="none" stroke="currentColor" stroke-width="2"
       stroke-linecap="round">
    <circle cx="12" cy="12" r="1"/>
    <circle cx="12" cy="5" r="1"/>
    <circle cx="12" cy="19" r="1"/>
  </svg>
</button>

<div id="demo-dropdown-4" role="menu" popover
     class="dropdown-content" aria-label="Actions"
     style="min-width:10rem;">
  <button role="menuitem" class="dropdown-item" tabindex="-1">Edit</button>
  <button role="menuitem" class="dropdown-item" tabindex="-1">Duplicate</button>
  <div class="dropdown-separator" role="separator"></div>
  <button role="menuitem" class="dropdown-item"
          data-variant="destructive" tabindex="-1">Delete</button>
</div>

Submenu

Open Share with the inline-end arrow, a click, or mouse hover.

CSS view file

/* -- Dropdown component ---------------------------------------- */

@layer components {
  .dropdown-content {
    background-color: var(--popover);
    color: var(--popover-foreground);
    border: none;
    border-radius: var(--radius-lg);
    padding: 0.25rem;
    box-sizing: border-box;
    min-width: min(8rem, calc(100dvw - 1rem));
    width: max(8rem, var(--menu-anchor-width, 0px));
    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);

    position: fixed;
    inset: var(--menu-y, auto) auto auto var(--menu-x, auto);
    margin: 0;
    opacity: 0;
    transition: opacity 100ms ease, display 100ms allow-discrete, overlay 100ms allow-discrete;

    &[data-dropdown-panel="submenu"] {
      width: max-content;
      min-width: min(6rem, calc(100dvw - 1rem));
    }

    &:popover-open { opacity: 1; }
  }

  @starting-style {
    .dropdown-content:popover-open { opacity: 0; }
  }

  .dropdown-item {
    display: flex;
    align-items: center;
    gap: 0.375rem;
    width: 100%;
    box-sizing: border-box;
    padding: 0.25rem 0.375rem;
    border-radius: var(--radius-md);
    font: inherit;
    font-size: 0.875rem;
    line-height: 1.25rem;
    border: none;
    background: transparent;
    color: var(--foreground);
    cursor: default;
    user-select: none;
    outline: none;
    text-align: start;

    &[data-inset] { padding-inline-start: 1.75rem; }
    & > svg { width: 1rem; height: 1rem; flex-shrink: 0; pointer-events: none; }

    &:focus, &[data-highlighted], &[aria-expanded="true"] {
      background-color: var(--accent);
      color: var(--accent-foreground);
    }

    &[data-variant="destructive"] {
      color: var(--destructive);
      &:focus, &[data-highlighted] {
        background-color: color-mix(in oklch, var(--destructive) 10%, transparent);
      }
    }

    .dark &[data-variant="destructive"]:is(:focus, [data-highlighted]) {
      background-color: color-mix(in oklch, var(--destructive) 20%, transparent);
    }

    &:is(:disabled, [aria-disabled="true"], [data-disabled]) {
      pointer-events: none;
      opacity: 0.5;
    }
  }

  /* -- Checkbox / Radio indicators ----------------------------- */
  .dropdown-check,
  .dropdown-radio {
    padding-inline-end: 2rem;
    position: relative;

    &::before {
      content: '';
      position: absolute;
      inset-inline-end: 0.5rem;
      top: 50%;
      transform: translateY(-50%);
      width: 0.875rem;
      height: 0.875rem;
    }
  }

  .dropdown-check[aria-checked="true"]::before {
    content: '';
    background-color: currentColor;
    mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='14' height='14' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M20 6 9 17l-5-5'/%3E%3C/svg%3E");
    mask-size: contain;
    mask-repeat: no-repeat;
  }

  .dropdown-radio[aria-checked="true"]::before {
    content: '';
    background-color: currentColor;
    mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='14' height='14' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='12' cy='12' r='5'/%3E%3C/svg%3E");
    mask-size: contain;
    mask-repeat: no-repeat;
  }

  .dropdown-separator {
    height: 1px;
    background: var(--border);
    margin: 0.25rem -0.25rem;
  }

  .dropdown-label {
    padding: 0.25rem 0.375rem;
    font-size: 0.75rem;
    font-weight: 500;
    color: var(--muted-foreground);
  }

  .dropdown-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;
  }

  .dropdown-item[data-dropdown-submenu]:dir(rtl)::after { rotate: -45deg; }

  .dropdown-shortcut {
    margin-inline-start: auto;
    font-size: 0.75rem;
    color: var(--muted-foreground);
    letter-spacing: 0.05em;
  }

  /* -- Accessibility ------------------------------------------ */

  @media (prefers-reduced-motion: reduce) {
    .dropdown-content {
      transition: none;
    }
    .dropdown-item {
      transition: none;
    }
  }

  @media (forced-colors: active) {
    .dropdown-content {
      outline: 1px solid CanvasText;
    }
    .dropdown-item {
      &:focus, &[data-highlighted], &[aria-expanded="true"] {
        forced-color-adjust: none;
        background: Highlight;
        color: HighlightText;
      }
    }
  }
}

JavaScript view file

Wires triggers to popover menus. The menu module handles viewport-aware placement. Keyboard navigation (Arrow keys, Home/End, Escape, Enter/Space), typeahead, and checkbox/radio state management.

// Shared native menu behavior. The popup remains in the browser's top layer.
const itemSelector = ':is([role="menuitem"], [role="menuitemcheckbox"], [role="menuitemradio"])';
const entries = new Map();
const gutter = 8;
let pendingPlacement = 0;
let pendingSubmenu = 0;

const menuOf = element => element?.closest('[role="menu"][popover]');
const disabled = item => item.matches(':disabled, [aria-disabled="true"], [data-disabled]');
const rtl = element => getComputedStyle(element).direction === 'rtl';

function items(menu) {
  return Array.from(menu.querySelectorAll(itemSelector))
    .filter(item => menuOf(item) === menu && !disabled(item) && item.getClientRects().length);
}

function focusItem(menu, item, preventScroll = false) {
  for (const candidate of menu.querySelectorAll(`${itemSelector}[data-highlighted]`)) {
    if (menuOf(candidate) === menu) candidate.removeAttribute('data-highlighted');
  }
  if (item) {
    item.dataset.highlighted = '';
    item.focus({ preventScroll });
  }
}

function positionMenu(menu, { trigger, parent, point }) {
  const viewport = window.visualViewport;
  const left = (viewport?.offsetLeft ?? 0) + gutter;
  const top = (viewport?.offsetTop ?? 0) + gutter;
  const right = left + (viewport?.width ?? document.documentElement.clientWidth) - gutter * 2;
  const bottom = top + (viewport?.height ?? document.documentElement.clientHeight) - gutter * 2;
  const anchor = trigger.getBoundingClientRect();
  const direction = rtl(trigger);
  if (!parent && !point) menu.style.setProperty('--menu-anchor-width', `${anchor.width}px`);
  const { width, height } = menu.getBoundingClientRect();

  let x = direction ? anchor.right - width : anchor.left;
  let y = anchor.bottom + 4;
  if (point) {
    x = direction ? point.x - width : point.x;
    y = point.y;
    if (x < left || x + width > right) x = direction ? point.x : point.x - width;
    if (y + height > bottom && point.y - height >= top) y = point.y - height;
  } else if (parent) {
    const rightSide = anchor.right + 4;
    const leftSide = anchor.left - width - 4;
    x = direction ? leftSide : rightSide;
    if (x < left || x + width > right) x = direction ? rightSide : leftSide;
    y = anchor.top;
  } else if (y + height > bottom && anchor.top - top > bottom - anchor.bottom) {
    y = anchor.top - height - 4;
  }

  menu.style.setProperty('--menu-x', `${Math.max(left, Math.min(x, right - width))}px`);
  menu.style.setProperty('--menu-y', `${Math.max(top, Math.min(y, bottom - height))}px`);
}

function positionOpenMenus() {
  if (!entries.size || pendingPlacement) return;
  pendingPlacement = requestAnimationFrame(() => {
    pendingPlacement = 0;
    for (const [menu, entry] of entries) {
      if (!menu.isConnected || !entry.trigger.isConnected) {
        if (menu.matches(':popover-open')) menu.hidePopover();
        entries.delete(menu);
      } else if (menu.matches(':popover-open')) {
        positionMenu(menu, entry);
      }
    }
  });
}

function closeMenu(menu, restore = false) {
  const entry = entries.get(menu);
  for (const [child, childEntry] of entries) {
    if (childEntry.parent === menu && child.matches(':popover-open')) closeMenu(child);
  }
  if (menu.matches(':popover-open')) menu.hidePopover();
  if (restore) entry?.trigger.focus({ preventScroll: true });
}

function rootMenu(menu) {
  while (entries.get(menu)?.parent) menu = entries.get(menu).parent;
  return menu;
}

export function openMenu(menu, trigger, { parent = null, point = null, last = false, focus = true } = {}) {
  if (!menu?.matches('[role="menu"][popover]')) return;
  for (const [sibling, entry] of entries) {
    if (parent && entry.parent === parent && sibling !== menu) closeMenu(sibling);
  }
  entries.set(menu, { trigger, parent, point });
  if (!menu.matches(':popover-open')) menu.showPopover({ source: trigger });
  positionMenu(menu, entries.get(menu));
  trigger.setAttribute('aria-expanded', 'true');
  if (!focus) return;
  const options = items(menu);
  focusItem(menu, last ? options.at(-1) : options[0], true);
  if (!options.length) {
    if (!menu.hasAttribute('tabindex')) menu.tabIndex = -1;
    menu.focus({ preventScroll: true });
  }
}

function targetMenu(trigger, attribute) {
  return document.getElementById(trigger.getAttribute(attribute));
}

function openSubmenu(item, menu, focus = true) {
  const submenu = targetMenu(item, 'data-dropdown-submenu');
  if (submenu && menu.contains(submenu) && submenu !== menu) openMenu(submenu, item, { parent: menu, focus });
}

document.addEventListener('toggle', event => {
  if (event.newState !== 'closed' || !entries.has(event.target)) return;
  const menu = event.target;
  const { trigger } = entries.get(menu);
  entries.delete(menu);
  trigger.setAttribute('aria-expanded', 'false');
  focusItem(menu);
}, true);

document.addEventListener('click', event => {
  if (!(event.target instanceof Element)) return;
  const item = event.target.closest(itemSelector);
  if (item && entries.has(menuOf(item)) && disabled(item)) {
    event.preventDefault();
    event.stopPropagation();
  }
}, true);

document.addEventListener('click', event => {
  if (event.defaultPrevented || !(event.target instanceof Element)) return;
  const trigger = event.target.closest('[data-dropdown-trigger]');
  if (trigger && !disabled(trigger)) {
    const menu = targetMenu(trigger, 'data-dropdown-trigger');
    if (menu?.matches(':popover-open') && entries.get(menu)?.trigger === trigger) closeMenu(menu);
    else openMenu(menu, trigger);
    return;
  }

  const item = event.target.closest(itemSelector);
  const menu = item && menuOf(item);
  if (!entries.has(menu)) return;
  if (item.hasAttribute('data-dropdown-submenu')) {
    openSubmenu(item, menu);
    return;
  }

  const role = item.getAttribute('role');
  if (role === 'menuitemcheckbox') {
    item.setAttribute('aria-checked', String(item.getAttribute('aria-checked') !== 'true'));
  } else if (role === 'menuitemradio') {
    const group = item.closest('[role="group"]') ?? menu;
    for (const radio of group.querySelectorAll('[role="menuitemradio"]')) {
      if (menuOf(radio) === menu) radio.setAttribute('aria-checked', String(radio === item));
    }
  } else {
    const root = rootMenu(menu);
    const focusedMenu = menuOf(document.activeElement);
    closeMenu(root, entries.has(focusedMenu) && rootMenu(focusedMenu) === root);
  }
});

document.addEventListener('pointermove', event => {
  if (event.pointerType !== 'mouse' || !(event.target instanceof Element)) return;
  const item = event.target.closest(itemSelector);
  const menu = item && menuOf(item);
  if (entries.has(menu) && !disabled(item) && item !== document.activeElement) {
    focusItem(menu, item, true);
  }
});

document.addEventListener('pointerover', event => {
  if (event.pointerType !== 'mouse' || !(event.target instanceof Element)) return;
  const item = event.target.closest(itemSelector);
  const menu = item && menuOf(item);
  if (!entries.has(menu) || disabled(item)) return;
  if (event.relatedTarget instanceof Node && item.contains(event.relatedTarget)) return;
  clearTimeout(pendingSubmenu);
  pendingSubmenu = setTimeout(() => {
    if (!menu.matches(':popover-open') || !item.matches(':hover')) return;
    if (item.hasAttribute('data-dropdown-submenu')) {
      openSubmenu(item, menu, false);
    } else {
      for (const [child, entry] of entries) {
        if (entry.parent === menu) closeMenu(child);
      }
    }
  }, 150);
});

document.addEventListener('keydown', event => {
  if (event.defaultPrevented || event.isComposing || !(event.target instanceof Element)) return;
  const menu = menuOf(event.target);
  const entry = entries.get(menu);
  if (!entry) {
    const trigger = event.target.closest('[data-dropdown-trigger]');
    if (trigger && !disabled(trigger) && ['ArrowDown', 'ArrowUp'].includes(event.key)) {
      event.preventDefault();
      openMenu(targetMenu(trigger, 'data-dropdown-trigger'), trigger, { last: event.key === 'ArrowUp' });
    }
    return;
  }

  const options = items(menu);
  const item = event.target.closest(itemSelector);
  const current = options.indexOf(item);
  const back = rtl(entry.trigger) ? 'ArrowRight' : 'ArrowLeft';
  const forward = back === 'ArrowRight' ? 'ArrowLeft' : 'ArrowRight';
  let next;

  switch (event.key) {
    case 'ArrowDown': next = options[(current + 1) % options.length]; break;
    case 'ArrowUp': next = options[(current < 0 ? options.length - 1 : current - 1 + options.length) % options.length]; break;
    case 'Home': next = options[0]; break;
    case 'End': next = options.at(-1); break;
    case 'Escape': event.preventDefault(); closeMenu(menu, true); return;
    case 'Tab': closeMenu(rootMenu(menu), true); return;
    case forward:
      if (item?.hasAttribute('data-dropdown-submenu') && !disabled(item)) {
        event.preventDefault();
        openSubmenu(item, menu);
      }
      return;
    case back:
      if (entry.parent) {
        event.preventDefault();
        closeMenu(menu, true);
      }
      return;
    case 'Enter':
    case ' ':
      if (item) {
        event.preventDefault();
        if (!disabled(item)) item.click();
      }
      return;
    default:
      if (event.key.length !== 1 || event.ctrlKey || event.metaKey || event.altKey) return;
      const ordered = [...options.slice(current + 1), ...options.slice(0, current + 1)];
      const key = event.key.toLocaleLowerCase();
      next = ordered.find(option => (option.getAttribute('aria-label') ?? option.textContent)
        .trim().toLocaleLowerCase().startsWith(key));
      if (!next) return;
  }
  event.preventDefault();
  focusItem(menu, next);
});

window.addEventListener('scroll', positionOpenMenus, { capture: true, passive: true });
window.addEventListener('resize', positionOpenMenus);
window.visualViewport?.addEventListener('resize', positionOpenMenus);
window.visualViewport?.addEventListener('scroll', positionOpenMenus);