id: dropdown_menu
label: Dropdown Menu
family: family-a-overlay
category: Action
intent: Show contextual action menu
description: Dropdown menu
composable: true
capabilities: OpenClose, Disabled
required_parts: ["DropdownMenuTrigger", "DropdownMenuContent"]
optional_parts: ["DropdownMenuItem", "DropdownMenuSeparator", "DropdownMenuGroup"]
tags: ["dropdown-menu", "dropdown", "menu", "options", "actions"]
keywords:
pain: Dropdown menus break keyboard navigation and selection state
promise: Menu interaction and state fully encoded via primitives
why: |
DropdownMenuPrimitive defines trigger/content with ARIA roles. ToggleState and ActivityState manage selection and highlight. This guarantees consistent menu behavior.
rules: ["CR-001", "CR-004"]
use_cases: ["actions menu", "user menu"]
related: ["context_menu", "menubar", "menu", "command"]
file: dropdown_menu_ui.css
tokens: dropdown-menu-*, space-*, radius-*, shadow-*, font-*
foundation: spacing, radius, shadow, typography
states: ["open", "closed"]
island: dropdown_menu_boundary.rs
pillar: menu
badges: ["SSR Safe", "Hydration Safe", "Token Driven", "Deterministic API", "Zero Drift", "Island Architecture"]
before: |
// ❌ Typical
view! {
<div class="dropdown">
<button>"Open"</button>
<div class="menu">"Item"</div>
</div>
}
after: |
// ✅ CanonRS
view! {
<DropdownMenu>
<DropdownMenuTrigger>"Open"</DropdownMenuTrigger>
<DropdownMenuContent>
<DropdownMenuItem>"Item"</DropdownMenuItem>
</DropdownMenuContent>
</DropdownMenu>
}
boundary_type: interaction
ix_group: ix_overlay
block: []
blocks_primitives: [stack]