Menu
<Menu> <MenuItem>First item</MenuItem> <MenuItem>Second item</MenuItem> <MenuItem>Third item</MenuItem></Menu>Menu separator
Section titled “Menu separator”<Menu> <MenuItem>Item 1</MenuItem> <MenuItem>Item 2</MenuItem> <MenuSeparator /> <MenuItem>Item 3</MenuItem> <MenuItem>Item 4</MenuItem></Menu>Menu with sections
Section titled “Menu with sections”<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 with a sub-menu
Section titled “Menu with a sub-menu”<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 item customization
Section titled “Menu item customization”<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>Single/multi-select menu items
Section titled “Single/multi-select menu items”<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>Highlighted props
Section titled “Highlighted props”For the complete list of props, use your IDE’s autocomplete functionality.
Trigger button customization
Section titled “Trigger button customization”<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>Advanced customizations
Section titled “Advanced customizations”triggerProps accepts all Button props.
<Menu triggerProps={{ size: 'small' }}> <MenuItem>First item</MenuItem> <MenuItem>Second item</MenuItem> <MenuItem>Third item</MenuItem></Menu>Keep open after item selection
Section titled “Keep open after item selection”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>Open on long press
Section titled “Open on long press”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>