Toggler
takes the setting to be the dynamically updated current value of x, with the value of x being toggled if the button is clicked.
Toggler[x,{val1,val2,…}]
represents a toggler button that cycles through any sequence of values vali.
Toggler[x,{val1pict1,val2pict2,…}]
cycles through values vali, displaying them as picti.
Toggler[x,vlist,dpict]
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:
-
AutoAction False whether to change the toggler automatically when the mouse is over it Background Automatic background color BaselinePosition Automatic alignment relative to surrounding text BaseStyle {} base style specifications for the displayed toggler ContentPadding True whether to shrink the margins tightly around the contents Enabled Automatic whether the toggler is enabled or grayed out ImageMargins 0 margins around the image of the displayed toggler ImageSize All the 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.
Examples
open all close allBasic Examples (2)
Scope (3)
Toggler[3, {1 -> "One", 2 -> "Two", 3 -> "Three"}]Display the last element () since the setting is not in the list of values:
Toggler[0, {1, 2}, Style[, 30]]Sometimes the setting is affected by external actions; in this display, "N/A":
{Button["x=a", x = a], Toggler[Dynamic[x], {1, 2, 3}, "N/A"]}Use any type of expression as values:
g = Plot[Sin[x], {x, 0, 2π}, Axes -> False, ImageSize -> 40];
f = Sqrt[y]Tan[α y - β];
s = "αβγ";{Toggler[Dynamic[x], {g, f, s}, Alignment -> Center], Dynamic[x]}Options (10)
Alignment (1)
Table[Toggler[1, {1, 2, 3}, Background -> Pink, ImageSize -> {30, 30}, Alignment -> a], {a, {Left, Right, Center, Bottom, Top}}]All possible alignment positions:
Table[Toggler[Dynamic[x], {1, 2, 3}, Background -> Pink, ImageSize -> {30, 30}, Alignment -> {j, i}], {i, {Top, Center, Bottom}}, {j, {Left, Center, Right}}]//GridAutoAction (2)
By default, clicking the output toggles its value:
Toggler[1, {1, 2, 3}]By setting AutoAction->True, the value toggles when the mouse moves over the output:
Toggler[1, {1, 2, 3}, AutoAction -> True]Background (1)
BaselinePosition (1)
Enabled (2)
FrameMargins (1)
ImageMargins (1)
Applications (1)
Use Toggler to create a tic-tac-toe board, where every cell knows the game logic:
Column[{Row[{"Player ", Toggler[Dynamic[player], {"X", "O"}, Enabled -> False]}], Grid[Table[Module[{x = " "}, Dynamic[Toggler[Dynamic[x, (x = #;player = player /. {"X" -> "O", "O" -> "X"};)&], {" ", player}, Enabled -> (Dynamic[x == " "]), ImageSize -> {15, 15}, Alignment -> {Center, Center}]]], {3}, {3}], Frame -> All]}]Text
Wolfram Research (2007), Toggler, Wolfram Language function, https://reference.wolfram.com/language/ref/Toggler.html.
CMS
Wolfram Language. 2007. "Toggler." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/Toggler.html.
APA
Wolfram Language. (2007). Toggler. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/Toggler.html