Dropdown Menu
A dropdown menu lists actions behind one button, such as the actions of a table row.
When to use
Section titled “When to use”- Use it when a row or card has more actions than fit as buttons.
- Put the most used action first and destructive actions last, after a separator.
- Use a Select to pick a value, not a menu.
Do and don’t
Section titled “Do and don’t”Anatomy
Section titled “Anatomy”- 1Trigger button
- 2Menu on elevation-lg
- 3Highlighted item
- 4Destructive item, last and after a separator
A trigger, usually a ghost icon button, and a popup on popover with a border, radius-lg and shadow-lg. Items use radius-md and highlight with accent.
Variants
Section titled “Variants”Items can be destructive (text-destructive), checkboxes, radio items or sub-menus.
| React | Vue | Flutter | Type | Default | Use |
|---|---|---|---|---|---|
DropdownMenuTrigger render |
DropdownMenuTrigger as-child |
child with controller.toggle |
element | button | The control that opens it. |
DropdownMenuItem variant |
DropdownMenuItem variant |
none | default | destructive |
default |
Marks a destructive action. |
onClick on an item |
@select on an item |
onPressed on ShadContextMenuItem |
function | none | Runs the action. |
import { MoreHorizontalIcon } from "lucide-react"import { Button } from "@/components/ui/button"import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger,} from "@/components/ui/dropdown-menu"
export default function DropdownMenuDemo() { return ( <DropdownMenu> <DropdownMenuTrigger render={<Button variant="ghost" size="icon" aria-label="Aksi" />}> <MoreHorizontalIcon /> </DropdownMenuTrigger> <DropdownMenuContent> <DropdownMenuItem>Lihat</DropdownMenuItem> <DropdownMenuItem>Ubah</DropdownMenuItem> <DropdownMenuSeparator /> <DropdownMenuItem variant="destructive">Hapus</DropdownMenuItem> </DropdownMenuContent> </DropdownMenu> )}<script setup lang="ts">import { MoreHorizontal } from "@lucide/vue"import { Button } from "@/components/ui/button"import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger,} from "@/components/ui/dropdown-menu"</script>
<template> <DropdownMenu> <DropdownMenuTrigger as-child> <Button variant="ghost" size="icon" aria-label="Aksi"><MoreHorizontal /></Button> </DropdownMenuTrigger> <DropdownMenuContent> <DropdownMenuItem>Lihat</DropdownMenuItem> <DropdownMenuItem>Ubah</DropdownMenuItem> <DropdownMenuSeparator /> <DropdownMenuItem variant="destructive">Hapus</DropdownMenuItem> </DropdownMenuContent> </DropdownMenu></template>import 'package:flutter/widgets.dart';import 'package:shadcn_ui/shadcn_ui.dart';
class DropdownMenuDemo extends StatefulWidget { const DropdownMenuDemo({super.key});
@override State<DropdownMenuDemo> createState() => _DropdownMenuDemoState();}
class _DropdownMenuDemoState extends State<DropdownMenuDemo> { final controller = ShadContextMenuController();
@override void dispose() { controller.dispose(); super.dispose(); }
@override Widget build(BuildContext context) { return ShadContextMenu( controller: controller, items: const [ ShadContextMenuItem(child: Text('Lihat')), ShadContextMenuItem(child: Text('Ubah')), ShadSeparator.horizontal(margin: EdgeInsets.symmetric(vertical: 4)), ShadContextMenuItem(child: Text('Hapus')), ], child: ShadIconButton.ghost( icon: const Icon(LucideIcons.ellipsis), onPressed: controller.toggle, ), ); }}Install
Section titled “Install”npx shadcn@latest add https://design.sosialoka.tech/r/react/dropdown-menu.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/dropdown-menu.jsonAccessibility
Section titled “Accessibility”- Renders
role="menu"andmenuitem; arrow keys move, Enter runs, Escape closes. - Icon-only triggers need an
aria-label.
