DropdownMenu provides a compact list of contextual actions from a trigger button.
Click or Enter/Space to open. Arrow keys navigate items. Enter activates an item. Escape closes the menu.
<DropdownMenu.Root>
<DropdownMenu.Trigger>Actions</DropdownMenu.Trigger>
<DropdownMenu.Content>
<DropdownMenu.Item>Edit</DropdownMenu.Item>
<DropdownMenu.Item>Duplicate</DropdownMenu.Item>
<DropdownMenu.Separator />
<DropdownMenu.Item>Delete</DropdownMenu.Item>
</DropdownMenu.Content>
</DropdownMenu.Root>Items organized in groups with labels. Group labels provide context for screen readers.
<DropdownMenu.Root>
<DropdownMenu.Trigger>File</DropdownMenu.Trigger>
<DropdownMenu.Content>
<DropdownMenu.Group>
<DropdownMenu.Label>Document</DropdownMenu.Label>
<DropdownMenu.Item>New</DropdownMenu.Item>
<DropdownMenu.Item>Open</DropdownMenu.Item>
</DropdownMenu.Group>
</DropdownMenu.Content>
</DropdownMenu.Root>Disabled menu items are skipped by keyboard navigation.
<DropdownMenu.Root>
<DropdownMenu.Trigger>Edit</DropdownMenu.Trigger>
<DropdownMenu.Content>
<DropdownMenu.Item>Cut</DropdownMenu.Item>
<DropdownMenu.Item>Copy</DropdownMenu.Item>
<DropdownMenu.Item disabled>Paste</DropdownMenu.Item>
</DropdownMenu.Content>
</DropdownMenu.Root>Modal menu traps focus inside. Tab does not leave the menu. Default behavior is modal.
<DropdownMenu.Root modal>
<DropdownMenu.Trigger>Modal Menu</DropdownMenu.Trigger>
<DropdownMenu.Content>
<DropdownMenu.Item>Item 1</DropdownMenu.Item>
</DropdownMenu.Content>
</DropdownMenu.Root>
<DropdownMenu.Root modal={false}>
<DropdownMenu.Trigger>Non-modal Menu</DropdownMenu.Trigger>
<DropdownMenu.Content>
<DropdownMenu.Item>Item 1</DropdownMenu.Item>
</DropdownMenu.Content>
</DropdownMenu.Root>With closeOnSelect={false}, menu stays open after selecting an item. Useful for multi-action menus.
<DropdownMenu.Root closeOnSelect={false}>
<DropdownMenu.Trigger>Multi-action</DropdownMenu.Trigger>
<DropdownMenu.Content>
<DropdownMenu.Item>Action A</DropdownMenu.Item>
<DropdownMenu.Item>Action B</DropdownMenu.Item>
</DropdownMenu.Content>
</DropdownMenu.Root>Parent fully controls the open state via open + onOpenChange. External buttons can programmatically open and close.
const [open, setOpen] = useState(false);
<DropdownMenu.Root open={open} onOpenChange={(o)=>setOpen(o)}>
<DropdownMenu.Trigger>Controlled</DropdownMenu.Trigger>
<DropdownMenu.Content>
<DropdownMenu.Item>Option A</DropdownMenu.Item>
</DropdownMenu.Content>
</DropdownMenu.Root>Disabled dropdown trigger prevents the menu from opening.
<DropdownMenu.Root disabled>
<DropdownMenu.Trigger>Disabled</DropdownMenu.Trigger>
<DropdownMenu.Content>
<DropdownMenu.Item>Unreachable</DropdownMenu.Item>
</DropdownMenu.Content>
</DropdownMenu.Root>Trigger exposes isOpen for custom rendering.
<DropdownMenu.Root>
<DropdownMenu.Trigger>
{({ isOpen }) => (isOpen ? 'Close' : 'Menu')}
</DropdownMenu.Trigger>
<DropdownMenu.Content>
<DropdownMenu.Item>Home</DropdownMenu.Item>
<DropdownMenu.Item>Settings</DropdownMenu.Item>
</DropdownMenu.Content>
</DropdownMenu.Root>