ButtonControl

In Xml, writing:

<j:Button bubbleEvent="selectItem" text="Button"/>

creates a button that, when clicked, bubbles an ID_selectItem event - telling its nearest List container to select the item corresponding to the button that was clicked.

In JavaScript, to set ID_bubbleEvent, you write:

var btn = new ButtonControl();
btn.setValue(ID_bubbleEvent, ID_selectItem);
...

In Xml, writing:

<j:Button click="alert('hello');" text="Foo"/>

creates a click event handler on the button. When the button is clicked, an alert pops up saying 'hello'.

In JavaScript, you write:

// create a click function
function myClick() { alert('Hello'); }

// create a button
var btn = new ButtonControl();

// register myClick as an event handler for the button
btn.addEventHandler(ID_click, new Delegate(btn, myClick));

When ID_isLink is true, the button control renders as <a onclick="..."> ID_text or children here ... </a>.

When ID_isLink is false, if the button has any children, the button renders as <span onclick="...">{children}</span>. If the button has no children, it renders as <input type="button" value="{text}">.