Skip to content
Edit this page
+

Menu

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

DemosComponents APIHooks API
import Menu from '@mui/base/Menu';
// or
import { Menu } from '@mui/base';
Learn about the difference by reading this guide on minimizing bundle size.

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

Type:

ref

An HTML element, virtualElement, or a function that returns either. It's used to set the position of the popper.

Type:

HTML element | object | func

Function called when the items displayed in the menu change.

Type:

func

Triggered when focus leaves the menu and the menu should close.

Type:

func

Controls whether the menu is displayed.

Type:

bool

Default:

false

The props used for each slot inside the Menu.

Type:

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

Default:

{}

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

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.

Global class: .MuiMenu-root

Description: The component that renders the root.

Global class: .MuiMenu-listbox

Description: The component that renders the listbox.


You can override the style of the component using one of these customization options:

These class names are useful for styling with CSS. They are applied to the root slot when specific states are triggered.

State class applied to the root Popper element and the listbox ul element if open={true}.


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.

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

Type:

string

The props used for each slot inside the MenuItem.

Type:

{ root?: func | object }

Default:

{}

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

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.

Global class: .MuiMenuItem-root

Description: The component that renders the root.


You can override the style of the component using one of these customization options:

These class names are useful for styling with CSS. They are applied to the root slot when specific states are triggered.

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

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