%META:TOPICINFO{author="ProjectContributor" comment="reprev" date="1732554276" format="1.1" version="1"}%
%META:TOPICPARENT{name="Macros"}%
---+ BUTTON -- renders a nice button 
---++ Parameters
     %TABLE{sort="off"}%
     | *Parameter* | *Description* | *Default* |
     | ="text"= | text to be put on this button | |
     | =value= | text to be put on this button | |
     | =accesskey= | access key used for this button | | 
     | =class= | e.g. use =simple= for a non-3D button | | 
     | =data_...= | add html5 data attributes | |
     | =align= | left, right, center |
     | =href= | url of the click target | # | 
     | =for= | will render a label pointing to an input element rather than a link |
     | =icon= | icon to be put on the left; note, this can be any icon attached to the  ={IconSearchPath}=; see also VarJQICON | | 
     | =id= | html id for this button | | 
     | =onclick= | javascript event triggered when clicking the button | | 
     | =target= | topic to open when clicking on the button | | 
     | =title= | popup title displayed when hovering over the button | | 
     | =type= | type of action to be performed; available actions are \
              <ul>\
                <li> =button= - normal click button, target specified in =target= or =href= parameter </li>\
                <li> =clear= - clears all input fields in the form that contains the button</li>\
                <li> =reset= - resets all input fields in a form to their initial value </li>\
                <li> =submit= - submits the form that contains the button</li>\
                <li> =save= - same as =submit= but takes care of extra validation steps when saving a wiki topic </li>\
              </ul> | =button= | 
---++ Examples

*You type*:

<verbatim class="tml">
%BUTTON{
   "%MAKETEXT{"Submit"}%"
   icon="fa-check"
   onclick="confirm('Are your sure?')"
}%
%BUTTON{
   "%MAKETEXT{"Cancel"}%"
   icon="fa-times"
   target="%WEB%.%TOPIC%"
}% 
</verbatim>

*You get*:

%BUTTON{
   "%MAKETEXT{"Submit"}%"
   icon="fa-check"
   onclick="confirm('Are your sure?')"
}%
%BUTTON{
   "%MAKETEXT{"Cancel"}%"
   icon="fa-times"
   target="%WEB%.%TOPIC%"
}% 

%STOPINCLUDE%

---++ Related
 JQueryButton
