Getting Started | API | Elements | Actions | Validators | Handlers | Configuration Options | Advanced Guides | Troubleshooting | About
The button element produces an HTML button. When clicked, the button will cause a Nitrogen postback.
#button { text="Go!", postback={click, goButton} }
body
(List of Nitrogen Elements) - The button's body (if you wanted to use something richer than a simple text)
text
(string) - The text of the button.
html_encode
(boolean) - Set to true to safely html-encode the text.
disabled
(boolean) - Set to true to disable this button in the browser (sets the HTML disabled
property, effectly greying out the element). Can be dynamically re-enabled with wf:enable(ElementID)
or wf:wire(ElementID, #enable{})
(Default: false
)
image
(Path to Image) - This is a shortcut attribute to prepending the body of the button with an image (for example, specifying a "Floppy Disk" icon on a "Save" button). The image will display before any body or text.
postback
(Erlang term) - Clicking on the button will initiate a Nitrogen postback with the supplied term.
click
(Action/ or /List of Actions) - Wires the selected actions to the "click" events. Due to the commonality of binding actions to the click event, this is merely a shortcut for
#button { text="Do Something", actions=[
#event{type=click,actions=ListOfActions}
]}
enter_clicks
(List of Element IDs) - Wires to the provided ElementIDs a #click{}
event on the provided button if the user presses the "Enter" key when any of the provided ElementIDs
have the focus. To see a working example, see the Security Demoenter_clicks
attribute)