button

Makes a button with an action attached.

This is an easy way to make a button and attach one or more actions or a postback.

For example:

{% button text="Click me" action={alert text="Hello Word!"} %}

This show a button with the text “Click me”. When clicked it will trigger the alert action, showing an alert message with the text “Hello World!”.

Another example:

{% button text="Postback" postback={my_postback arg1=1 arg2=2} %}

When clicked it will call the event/2 function in the controller that served the page. The function will be called as:

event(#postback{message={mypostback, [{arg1,1}, {arg2,2}]},
    trigger=TriggerId, target=TargetId}, Context)

Where TriggerId and TargetId are both the HTML id of the button.

button accepts the following arguments:

Argument Description Example
text The text on the button, defaults to “Submit” text=”click me”
postback An event sent to the delegate or the resource serving the page. postback=”hello”
tag The type of HTML tag that will be created. Defaults to “button”. tag=”a”
delegate The name of the erlang module to be called for handling the postback. delegate=”myresource”
action The action to be triggered when the button is clicked. There can be more than one action argument. action={show target=”msg”}
id Id of the button. id=#submit
class The css class of the button. This argument can be repeated to add multiple classes. class=”submit”
style The css style of the button. style=”color: #fc0”
tabindex The value for the tabindex property. tabindex=1
type The type attribute of the button. type=”submit”
title The title attribute of the button. title=”click to submit”
disabled The disabled attribute of the button, set to true or false. When the button is disabled then the class “disabled” id added to the class list. disabled=true
href The href attribute of the button if tag “a” is used. Defaults to “#”. href=”/foobar”

Edit on GitHub