Overview
A Button Menu trigger opens a native menu when the user taps on the button the trigger is placed on. Button Menu triggers need Menu Actions placed on them to create menu items. Each of the menu items can fire other actions when selected.
Button Menu triggers can also create native menus with sections or submenus, created with Submenu actions.
Button Menu triggers can only be added to native buttons (UI Button and SwiftUI Button). If you’d like to add a native menu to a non-button object or a nav bar item, use a Context Menu trigger or a Bar Item trigger, respectively.
Trigger Properties
Title
Set the menu’s title which will appear at the top of the menu. To remove the title, just set this property to empty.
Subtitle
Set the menu’s subtitle which will appear at the top of the menu. To remove the subtitle, just set this property to empty.
Element Size
Set the size of the native menu items:
Small: The first four menu items will appear horizontally with icons only, and the remaining items will display in a list below.
Medium: The first three menu items will appear horizontally with icons and labels, and the remaining items will display in a list below.
Large: All menu items are in the list, except for items in sub-panels.
Automatic
Note: Element Size is not relevant for Palette Display menus.
Display
Choose the menu’s display type:
Palette: Menu item icons are placed horizontally using only their icon, unless a menu item has no icon, in which case the title will be displayed.
Inline: Menu items are placed normally with dividers creating a subsection.
Default: Menu items are placed in a submenu.
Destructive
Choose if the menu title displays in red.
Single Selection
Choose if only one item can be selected (have a check mark next to it) at once. By default, multi select is enabled.
Build on Load
Choose if the menu should build when the page loads or if it should wait for a Reload Menu action.