Skip to content

Menu

The Dropdown Menu components provide end users with a list of options on temporary surfaces.

Component demos Components API Hooks API

import { Dropdown } from '@mui/base/Dropdown';
// or
import { Dropdown } from '@mui/base';

Learn about the difference by reading this guide on minimizing bundle size.

The component cannot hold a ref.

import { Menu } from '@mui/base/Menu';
// or
import { Menu } from '@mui/base';

Learn about the difference by reading this guide on minimizing bundle size.

Props of the native component are also available.

actions

A ref with imperative actions that can be performed on the menu.

Type:ref

anchor

The element based on which the menu is positioned.

Type:HTML element | object | func

onItemsChange

Function called when the items displayed in the menu change.

Type:func

slotProps

The props used for each slot inside the Menu.

Type:{ listbox?: func | object, root?: func | object }

Default:{}

slots

The components used for each slot inside the Menu. Either a string to use a HTML element or a component.

See Slots API below for more details.

Type:{ listbox?: elementType, root?: elementType }

Default:{}

The ref is forwarded to the root element.

To learn how to customize the slot, check out the Overriding component structure guide.

root

The component that renders the popup element.

Class name: .base-Menu-root

Default component: 'div'

listbox

The component that renders the listbox.

Class name: .base-Menu-listbox

Default component: 'ul'

These class names are useful for styling with CSS. They are applied to the component's slots when specific states are triggered.

.base--expandedSTATE

State class applied to the root element if open={true}.

import { MenuButton } from '@mui/base/MenuButton';
// or
import { MenuButton } from '@mui/base';

Learn about the difference by reading this guide on minimizing bundle size.

Props of the native component are also available.

className

Class name applied to the root element.

Type:string

disabled

If true, the component is disabled.

Type:bool

Default:false

focusableWhenDisabled

If true, allows a disabled button to receive focus.

Type:bool

Default:false

label

Label of the button

Type:string

slotProps

The components used for each slot inside the MenuButton. Either a string to use a HTML element or a component.

Type:{ root?: func | object }

Default:{}

slots

The props used for each slot inside the MenuButton.

See Slots API below for more details.

Type:{ root?: elementType }

Default:{}

The ref is forwarded to the root element.

To learn how to customize the slot, check out the Overriding component structure guide.

root

The component that renders the root.

Class name: .base-MenuButton-root

Default component: 'button'

These class names are useful for styling with CSS. They are applied to the component's slots when specific states are triggered.

.base--activeSTATE

State class applied to the root element if active={true}.

.base--disabledSTATE

State class applied to the root element if disabled={true}.

.base--expandedSTATE

State class applied to the root element if the associated menu is open.

import { MenuItem } from '@mui/base/MenuItem';
// or
import { MenuItem } from '@mui/base';

Learn about the difference by reading this guide on minimizing bundle size.

Props of the native component are also available.

disabled

If true, the menu item will be disabled.

Type:bool

Default:false

label

A text representation of the menu item's content. Used for keyboard text navigation matching.

Type:string

slotProps

The props used for each slot inside the MenuItem.

Type:{ root?: func | object }

Default:{}

slots

The components used for each slot inside the MenuItem. Either a string to use a HTML element or a component.

See Slots API below for more details.

Type:{ root?: elementType }

Default:{}

The ref is forwarded to the root element.

To learn how to customize the slot, check out the Overriding component structure guide.

root

The component that renders the root.

Class name: .base-MenuItem-root

Default component: 'li'

These class names are useful for styling with CSS. They are applied to the component's slots when specific states are triggered.

.base--disabledSTATE

State class applied to the root button element if disabled={true}.

.base--focusVisibleSTATE

State class applied to the root button element if focusVisible={true}.