User Tools

Site Tools


button

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
button [2014/06/15 23:17]
l created
button [2017/10/10 00:39] (current)
Line 1: Line 1:
 =====<<​button>>​===== =====<<​button>>​=====
  
-The <<​button>>​ macro creates a button that, when clicked, sets the data entered into other form macros in the passage ([[<<​textinput>>​]],​ [[<<​radio>>​]],​ [[<<​checkbox>>​]]),​ and moves to another passage.+The **<<​button>>​** [[macro]] creates a button, a special type of [[link]] ​that, when clicked, sets the data entered into other form macros in the passage ([[<<​textinput>>​]],​ [[<<​radio>>​]],​ [[<<​checkbox>>​]]),​ and moves to another passage.
  
 ====Usage==== ====Usage====
  
-The <<​button>>​ macro should be provided with link:+The <<​button>>​ macro should be provided with the familiar ​link syntax:
  
 >​%%<<​%%button %%[[%%//​displayed text//​|//​passage name//​%%]]>>​%% >​%%<<​%%button %%[[%%//​displayed text//​|//​passage name//​%%]]>>​%%
  
-The resulting button behaves identically to the link, but, when clicked, additionally causes the data entered into [[<<​textinput>>​]],​ [[<<​radio>>​]] and [[<<​checkbox>>​]] macros to be set to the given [[variable]]s.+The resulting button behaves identically to a normal ​link, but, when clicked, additionally causes the data entered into [[<<​textinput>>​]],​ [[<<​radio>>​]] and [[<<​checkbox>>​]] macros to be placed in the [[variable]]s
 + 
 +For instance, if the macro ''<<​textinput $FoodName>>''​ appears in the same passage with a <<​button>>,​ and the  text "​pretzels"​ has been entered into the input box, then clicking the button will, in addition to changing passages, run the equivalent of ''<<​set $FoodName to "​pretzels">>''​.
button.1402874258.txt.gz · Last modified: 2017/10/10 00:37 (external edit)