Dropdown Menu
Displays a menu to the user — such as a set of actions or functions — triggered by a button.
Installation#
pnpm dlx shadcn@latest add @davinciui/dropdown-menuUsage#
Composition: DropdownMenu → DropdownMenuTrigger + DropdownMenuContent → DropdownMenuLabel / DropdownMenuItem / DropdownMenuSeparator. Submenus via DropdownMenuSub → DropdownMenuSubTrigger + DropdownMenuSubContent.
State: Checkboxes use DropdownMenuCheckboxItem checked onCheckedChange; single-select uses DropdownMenuRadioGroup value onValueChange + DropdownMenuRadioItem value.
Styling: Destructive actions via DropdownMenuItem variant="destructive"; hints via DropdownMenuShortcut; indent labels with inset.
Basic#
Shortcuts#
Icons#
Checkboxes#
Checkboxes Icons#
Radio Group#
Radio Icons#
Destructive#
Rich items#
Avatar#
Complex#
RTL#
Composition#
Use the following composition to build a Dropdown Menu:
DropdownMenu
├── DropdownMenuTrigger
└── DropdownMenuContent
├── DropdownMenuLabel
├── DropdownMenuItem (+ Shortcut)
├── DropdownMenuCheckboxItem
├── DropdownMenuRadioGroup
│ └── DropdownMenuRadioItem
├── DropdownMenuSeparator
└── DropdownMenuSub
├── DropdownMenuSubTrigger
└── DropdownMenuSubContentAPI Reference#
| Prop | Type | Default |
|---|---|---|
DropdownMenuRoot. Controls open state. | Component | — |
DropdownMenuTriggerButton that opens the menu. Supports asChild. | Component | — |
DropdownMenuContentPopup menu. Props: align, side, sideOffset, alignOffset, collisionPadding. | Component | — |
DropdownMenuItemMenu action. Props: inset, variant (default | destructive), icon, description, shortcut, kbd, badge. | Component | — |
DropdownMenuLabelSection label. Prop: inset. | Component | — |
DropdownMenuSeparatorDivider line between sections. | Component | — |
DropdownMenuShortcutKeyboard hint, right-aligned. | Component | — |
DropdownMenuGroupGroups related items. | Component | — |
DropdownMenuCheckboxItemToggle item. Props: checked, onCheckedChange, icon, description, shortcut, kbd. | Component | — |
DropdownMenuRadioGroupSingle-select group. Props: value, onValueChange. | Component | — |
DropdownMenuRadioItemRadio option. Props: value, description, shortcut. | Component | — |
DropdownMenuSubSubmenu root. | Component | — |
DropdownMenuSubTriggerOpens the submenu. Prop: inset. | Component | — |
DropdownMenuSubContentSubmenu popup. | Component | — |
classNameAdditional CSS classes. | string | — |
Accessibility#
Base UI provides role='menu', arrow-key roving focus, type-ahead, Escape dismissal, submenu handling, and focus return. Checkbox and radio items expose checked state through the primitive. DropdownMenuLabel and DropdownMenuShortcut are aria-hidden, so section headings and shortcut hints are not announced.
Motion#
The popup fades, translates 4px, and scales 0.96 over 150ms with cubic-bezier(0.23,1,0.32,1). Check and radio indicators scale in over 150ms, and items press to 0.99. motion-reduce:transition-none disables these transitions and the starting transform.
View source
Keep in mind
Need a custom component?
I build bespoke UI components & websites tailored to your brand.

