Skip to main content
← All Demos

DropdownMenu

DropdownMenu provides a compact list of contextual actions from a trigger button.

1. Basic Dropdown Menu

Click or Enter/Space to open. Arrow keys navigate items. Enter activates an item. Escape closes the menu.

Keyboard: Enter/Space to open → ↑↓ to navigate → Enter to select → Escape to close
<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>

2. Grouped Items with Labels

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>

3. Disabled Items

Disabled menu items are skipped by keyboard navigation.

Expected: Arrow keys skip "Paste (disabled)".
<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>

4. Modal Menu (Focus Trap)

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>

5. Keep Open After Selection

With closeOnSelect={false}, menu stays open after selecting an item. Useful for multi-action menus.

Expected: Menu stays open after selecting. Press Escape to close.
<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>

6. Controlled Dropdown

Parent fully controls the open state via open + onOpenChange. External buttons can programmatically open and close.

Expected: External buttons control the menu. Trigger and Escape also work.
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>

7. Disabled Trigger

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>

8. Render Props Pattern

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>
← All Demos