represents a popup menu with setting x and possible values vali.


takes the setting to be the dynamically updated current value of x, with the value of x being reset every time an item is selected from the menu.


represents a popup menu in which possible value vali is indicated by lbli.


displays the menu item as dlbl if x is none of the vali.


displays as base when it is not being clicked.

Details and Options

  • PopupMenu[x,{val1,val2,}] displays with the vali as successive entries in the menu.
  • The vali and lbli can be strings, boxes, graphics or any other expressions, including dynamic expressions.
  • In PopupMenu[x,list], Delimiter can appear as an element of list, specifying a horizontal delimiter in the displayed popup menu.
  • The following options can be given:
  • AppearanceAutomaticthe overall appearance of the menu
    BaselinePositionAutomaticalignment relative to surrounding text
    BaseStyle{}base style specifications for the menu
    ContentPaddingTruewhether to shrink the margins tightly around the contents
    EnabledAutomaticwhether the menu is enabled, or grayed out
    FieldSize{{1.,50.},{1.,10.}}the size of the field for menu items
    FrameMarginsAutomaticmargins to leave inside the menu frame
    ImageMargins0margins around the displayed menu
    ImageSizeAllthe overall image size of the displayed menu
    MenuStyle{}style specifications for menu items
  • Appearance->{"Clicked"->app1,"Unclicked"->app2} allows different appearances to be specified for the clicked and unclicked states of the popup menu.
  • The settings for BaseStyle are appended to the default style typically given by the "PopupMenu" style in the current stylesheet.


open all close all

Basic Examples  (2)

Select values from a popup menu:

Click for copyable input

Connect PopupMenu to a dynamic state:

Click for copyable input

Scope  (7)

Options  (11)

Applications  (1)

Properties & Relations  (1)

Introduced in 2007
Updated in 2010