Menu API

A headless menu for a button, a right-click, or a menubar, including submenus.

Explore these related pages for additional context and usage patterns.

Page	Category
Menu	Disclosure
Popover	Disclosure
usePopover	System

id

string | undefined

DOM id prefix for the menu and the controls that open it

value

any

Layer id used when an activator or content omits value

disabled

boolean | undefined

Disables every activator and item in this menu

Default: false

openDelay

number | undefined

Delay before a hover or pointer open. Keyboard, click, and right-click skip it.

Default: 100

closeDelay

number | undefined

Delay before a hover-opened menu closes after the pointer leaves

Default: 250

openOnHover

boolean | undefined

Open the top menu when the pointer rests on its activator

Default: false

namespace

string | undefined

Injection key.

Default: "v0:menu"

modelValue

any

Default: null

default

MenuRootSlotProps

value

any

Layer this activator opens. Omit it to use Menu.Root's value.

disabled

MaybeRefOrGetter<boolean> | undefined

Disables this activator

Default: false

namespace

string | undefined

Injection key of the owning menu.

Default: "v0:menu"

default

MenuActivatorSlotProps

namespace

string | undefined

Injection key of the owning menu.

Default: "v0:menu"

default

MenuBarSlotProps

id

any

Stable id. Auto-generated when omitted.

label

string | undefined

Typeahead text. Falls back to the item's text.

disabled

MaybeRefOrGetter<boolean> | undefined

Disables the gesture. The checked model can still be written.

Default: false

namespace

string | undefined

Injection key of the owning menu.

Default: "v0:menu"

checked

boolean | undefined

Default: false

update:checked

unknown[]

default

MenuCheckboxItemSlotProps

value

any

Layer this popup belongs to. Omit it to use Menu.Root's value.

eager

boolean | undefined

Render items before the first open

Default: false

positionArea

string | undefined

CSS position-area for the popup.

positionTry

string | undefined

CSS position-try fallbacks

namespace

string | undefined

Injection key of the owning menu.

Default: "v0:menu"

default

MenuContentSlotProps

namespace

string | undefined

Injection key of the owning menu.

Default: "v0:menu"

default

MenuContextSlotProps

id

any

Stable id. Auto-generated when omitted.

label

string | undefined

Typeahead text. Falls back to the item's text.

disabled

MaybeRefOrGetter<boolean> | undefined

Disables this item

Default: false

namespace

string | undefined

Injection key of the owning menu.

Default: "v0:menu"

default

MenuItemSlotProps

label

string | undefined

Accessible name for the group

disabled

boolean | undefined

Disables every radio in the group

Default: false

modelValue

unknown

default

MenuRadioGroupSlotProps

value required

unknown

Value written to the group model when this item is selected

id

any

Stable id. Auto-generated when omitted.

label

string | undefined

Typeahead text. Falls back to the item's text.

disabled

MaybeRefOrGetter<boolean> | undefined

Disables the gesture. The group model can still be written.

Default: false

namespace

string | undefined

Injection key of the owning menu.

Default: "v0:menu"

default

MenuRadioItemSlotProps

default

MenuSeparatorSlotProps

value

any

Layer id for this submenu. Auto-generated when omitted.

default

{}

id

any

Stable id. Auto-generated when omitted.

label

string | undefined

Typeahead text. Falls back to the item's text.

disabled

MaybeRefOrGetter<boolean> | undefined

Disables this item

Default: false

namespace

string | undefined

Injection key of the owning menu.

Default: "v0:menu"

default

MenuSubActivatorSlotProps

eager

boolean | undefined

Render items before the first open

Default: false

positionArea

string | undefined

CSS position-area for the submenu.

positionTry

string | undefined

CSS position-try fallbacks.

namespace

string | undefined

Injection key of the owning menu.

Default: "v0:menu"

default

MenuSubContentSlotProps