Overlays

DropdownMenu

Popover-backed menu surface that hosts dropdown-item rows and owns arrow-key, Home, End, and Escape navigation.

import { DropdownMenu } from '@lostgradient/cinder/dropdown-menu';
overlaymenu
01

Overview

Floating list of actions or options that opens from a trigger element.

Usage

DropdownMenu is a compose-only leaf of Dropdown. The idiomatic API is Dropdown.Menu, reached through the parent namespace — see the dropdown README for the composed snippet. The flat @lostgradient/cinder/dropdown-menu subpath remains exported for à-la-carte builds that import the leaf directly.

02

When to use

Use when
  • Rendering the floating panel that holds a dropdown's menu items.
  • Composing a dropdown's body from dropdown-item, dropdown-label, and dropdown-separator children.
Avoid when
  • Used outside a dropdown context — it requires the dropdown provider and will throw otherwise.
  • Showing arbitrary non-menu content — use popover.
03

Props

Props for dropdown-menu
Name Type Default Required Bindable Description
children snippet
dir unknown req