Dropdown Menu

Toggleable menu for displaying lists of links or actions

Preview

Installation

Usage

Examples

With Icons and Shortcuts

Add icons and keyboard shortcuts to menu items.

With Checkboxes

Include checkbox menu items for toggleable options.

With Radio Group

Use radio groups for mutually exclusive options.

With Sub Menu

Create nested submenus for hierarchical navigation.

API Reference

The DropdownMenu component is built on top of Base UI's Menu. All Base UI props are supported. The documentation below only covers custom props and modified defaults specific to our implementation.

For the complete Base UI API, see the Base UI Menu documentation.

Props

Dropdown container with positioning and animations. Composes Menu.Portal, Menu.Positioner, and Menu.Popup. Props are forwarded to Menu.Popup.

Prop

Individual menu item. Wraps Base UI's Menu.Item.

Prop

Non-interactive label for grouping items.

Prop

Label for a menu group. Wraps Base UI's Menu.GroupLabel.

Prop

Item that opens a submenu on hover. Wraps Base UI's Menu.SubmenuTrigger.

Prop

Submenu container with positioning. Composes Menu.Portal, Menu.Positioner, and Menu.Popup. Props are forwarded to Menu.Popup.

Prop