Common Attributes

Name	Description
id	Used to reference the xul element in code
flex	a relative value describing the size of an element relative to its siblings

Tabs and Tab Panels

tabbox

The root element of a tab box

tabs

The parent element of the tab descriptions

tab

A tab displayed to the user

Custom Attributes

Name	Description
label	The Label displayed on the tab

tabpanels

The parent element of all tab panels

tabpanel

An individual tab panel

Tab Example:

Text Box

The textbox element can act as a single or multiline editable text box

Custom Attributes

Name	Description
maxlength	The Label displayed on the tab
multiline	true if the text box should span multiple lines
value	the value displayed in the textbox

Trees and Tables

The Tree and Table components in XUL share the same parent element, tree.

tree

This element is the parent of all related tree and table elements.

Custom Attributes

Name	Description
editable	true or false, denotes if the tree is editable, used in relation to bindings
hiddenrootnode	If in tree mode, determines if the root node should be rendered or not
preserveselection	(Not implemented in Swing)
onselect	the controller method to call when an item is selected in the tree or table

treecols

This element is the parent element for treecol

treecol

This element describes a column in a tree or table

Custom Attributes

Name	Description
label	The column name
primary	???
type	The type of the column, IE text (TODO: Need full list of types supported per environment)
pen:binding	The binding method name to get the column value
pen:childrenbinding	The binding method name to get a list of children for this column
editable	If true, denotes that this column is editable
pen:disabledbinding	???
pen:tooltipbinding	The binding method name to get the tooltip value
pen:expandedbinding	The binding method name to get the expanded boolean value

treechildren

TODO

treeitem

TODO

treerow

TODO

treecell

TODO

Tree and Table Examples

TODO

menulist

The menulist is used for dropdowns

menulist

This element is the root element for dropdowns

Custom Attributes

Name	Description
pen:binding	The get and set method to bind the menulist to
oncommand	The controller method to call when a user selects an element in the menu list

menupopup

This element contains menu items

menuitem

This element acts as a single dropdown or menu item

Custom Attributes

Name	Description
label	the value that appears as the menu item

Example

Example binding, usually defined in a controller's init. This populates the menulist with the contents of the method getListItems() in the controller:

XulMenuList<String> list = (XulMenuList<String>) document.getElementById("list");
Binding b = bf.createBinding(this, "listItems", list, "elements");
b.fireSourceChanged();

label

This is used to display static text within the UI.

Custom Attributes

Name	Description
value	The text to display.
disabled	If true, display the label in a disabled state.