represents a toggler button with setting x, that toggles between True and False.


takes the setting to be the dynamically updated current value of x, with the value of x being toggled if the button is clicked.


represents a toggler button that cycles through any sequence of values vali.


cycles through values vali displaying them as picti.


displays as dpict if x is none of the vali.

Details and Options

  • Checkbox and Opener are effectively special cases of Toggler. »
  • Toggler[x] by default displays as x.
  • Clicking anywhere inside a Toggler advances to the next value.
  • Shift-clicking goes to the previous value.
  • The dpict case cannot be reached by clicking, only by externally setting x. »
  • The vali and picti in Toggler can be strings, boxes, graphics or any other expressions, including dynamic expressions. »
  • The following options can be given:
  • AutoActionFalsewhether to change the toggler automatically when the mouse is over it
    BaselinePositionAutomaticalignment relative to surrounding text
    BaseStyle{}base style specifications for the displayed toggler
    ContentPaddingTruewhether to shrink the margins tightly around the contents
    EnabledAutomaticwhether the toggler is enabled or grayed out
    ImageMargins0margins around the image of the displayed toggler
    ImageSizeAllthe overall image size of the displayed toggler
  • Controls such as Button and Slider are not clickable inside Toggler.
  • EventHandler intercepts mouse clicks, but passes them through to Toggler if the setting PassEventsDown->True is given.
  • The settings for BaseStyle are appended to the default style typically given by the "Toggler" style in the current stylesheet.


open all close all

Basic Examples  (2)

Click the output to toggle its value:

Click for copyable input

Dynamically change the value of :

Click for copyable input

Scope  (3)

Options  (10)

Applications  (1)

Properties & Relations  (1)

Introduced in 2007