Action Menu Button

Pairs a primary command with a chevron menu for related alternates — for example, Save alongside Save as and Export.

Wire the main action with on_click and menu picks with on_select. Do not repeat the primary label in menu items. When menu labels are abbreviated, ensure surrounding context gives screen-reader users enough detail.

  • One dominant action plus a small set of related alternates in a menu - Save / Save as / Export, Send / Schedule send, and similar command clusters
  • Put primary label text in children and menu items in the action_menu_items slot.
  • Wire on_click for the primary segment and on_select for menu item values.
  • Prefer MenuButton when every choice lives in the menu with no separate primary click.
Default action menu button

Primary save action with a chevron menu for alternates.

With icon

Primary segment includes a leading icon.