Skip to content

Menu

<Menu>
<MenuItem>First item</MenuItem>
<MenuItem>Second item</MenuItem>
<MenuItem>Third item</MenuItem>
</Menu>
<Menu>
<MenuItem>Item 1</MenuItem>
<MenuItem>Item 2</MenuItem>
<MenuSeparator />
<MenuItem>Item 3</MenuItem>
<MenuItem>Item 4</MenuItem>
</Menu>
<Menu>
<MenuSection label='Section 1'>
<MenuItem>Item 1</MenuItem>
<MenuItem>Item 2</MenuItem>
</MenuSection>
<MenuSection label='Section 2'>
<MenuItem>Item 3</MenuItem>
<MenuItem>Item 4</MenuItem>
</MenuSection>
</Menu>

If you need to have a top-level menu item outside of any sections you can either add a section without a label, or use MenuSeparator elements with a disabled MenuItem to act as the section label.

<Menu>
<MenuItem>Item 1</MenuItem>
<MenuItem>Item 2</MenuItem>
<SubMenuItem trigger={<MenuItem>Submenu</MenuItem>}>
<MenuItem>Subitem 1</MenuItem>
<MenuItem>Subitem 2</MenuItem>
</SubMenuItem>
</Menu>
<Menu>
<MenuItem
icon={emptyCircle}
>
Item with icon
</MenuItem>
<MenuItem
endIcon={emptyRect}
>
Item with end icon
</MenuItem>
<MenuItem
shortcut='Ctrl + Z'
>
Item with shortcut text
</MenuItem>
<MenuItem
disabled
>
Disabled item
</MenuItem>
</Menu>
<Menu>
<MenuItem
checked={myValue === 'a'}
onClick={() => setMyValue('a')}
>
Item A
</MenuItem>
<MenuItem
checked={myValue === 'b'}
onClick={() => setMyValue('b')}
>
Item B
</MenuItem>
<MenuItem
checked={myValue === 'c'}
onClick={() => setMyValue('c')}
>
Item C
</MenuItem>
</Menu>
<Menu>
<MenuItem
checked={myValue}
onClick={() => setMyValue(!myValue)}
>
Item
</MenuItem>
</Menu>

For the complete list of props, use your IDE’s autocomplete functionality.

<Menu
triggerLabel='Menu'
>
<MenuItem>First item</MenuItem>
<MenuItem>Second item</MenuItem>
<MenuItem>Third item</MenuItem>
</Menu>
<Menu
triggerLabel='Menu'
triggerIcon={emptyCircle}
>
<MenuItem>First item</MenuItem>
<MenuItem>Second item</MenuItem>
<MenuItem>Third item</MenuItem>
</Menu>

triggerProps accepts all Button props.

<Menu
triggerProps={{ size: 'small' }}
>
<MenuItem>First item</MenuItem>
<MenuItem>Second item</MenuItem>
<MenuItem>Third item</MenuItem>
</Menu>

By default, the menu will close after an item is selected. If you want to keep it open, use the keepOpen prop.

<Menu
keepOpen
>
<MenuItem>First item</MenuItem>
<MenuItem>Second item</MenuItem>
<MenuItem>Third item</MenuItem>
</Menu>

If you want the menu to open on long press instead of click, use the openOnLongPress prop.

<Menu
openOnLongPress
>
<MenuItem>First item</MenuItem>
<MenuItem>Second item</MenuItem>
<MenuItem>Third item</MenuItem>
</Menu>

This allows implementing a button that can, for example, act as a toggle button by default, but open a menu on long press.

Be careful about UX and discoverability in those cases.

Click to toggle ‘bold’, press and hold for more font weights.

<Menu
triggerIcon={bold}
tooltip='Font weight'
triggerProps={{
type: fontWeight === '700' ? 'selected' : 'default',
onPress: () => setData(fontWeight === '700' ? '400' : '700'),
}}
openOnLongPress
>
<MenuItem selected={fontWeight === '300'} onClick={...}>
Light
</MenuItem>
<MenuItem selected={fontWeight === '400'} onClick={...}>
Regular
</MenuItem>
<MenuItem selected={fontWeight === '500'} onClick={...}>
Medium
</MenuItem>
<MenuItem selected={fontWeight === '700'} onClick={...}>
Bold
</MenuItem>
</Menu>