The living catalog

Elements05/15

Menu

G2G9

ONE floating-menu engine for dropdown, right-click, and overflow actions: items, icons, printed keys, checkbox items, danger items, max one submenu level.

Posture

Dropdown — one engine

Context — right-click the panel (same engine, same skin)

Right-clickable region

npx candlelight-ds add menu

Use when

Contextual actions on an object — dropdown, right-click, or overflow.

Don't use when

Navigation (links) or picking data values (Select). Deeper than one submenu level (Overlay).

States
closedopenitem highlighteditem disableddanger itemcheckbox itemsubmenu open
Keyboard
  • ↑↓walk items
  • Enterselect
  • Escclose
  • typetypeahead
Acceptance
  • A second menu engine anywhere is a bug — dropdown and context modes share this one skin.
  • closeOnSelect:false keeps the menu open for rapid-fire actions.
  • Danger items wear the cold tone and pair with hold-to-strike for destruction.

Raw twin: /components/menu.md·Registry item: /r/menu.json