Dropdown Menu
Context menu built on the popover API. Light-dismiss is automatic.
Supports groups, shortcuts, separators, and destructive items. Animated with @starting-style.
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">…</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">…</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">…</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">…</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">…</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);