Supported Xul Components

Owned by Former user (Deleted)
Last updated: Jul 28, 2010Version comment
2 min read

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:

<tabbox  id="tabbox">
                <tabs id="tabs">
                   <tab id="firstTab" label="First Tab" />
                   <tab id="secondTab" label="Second Tab" />
                </tabs>
                <tabpanels id="tabpanels">
    <tabpanel id="firstTabPanel">
    <!- Content goes here ->
   </tabpanel>

    <tabpanel id="firstTabPanel">
    <!- Content goes here ->
   </tabpanel>
</tabbox>   

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

<menulist id="list" pen:binding="name">
    <menupopup>
        <menuitem label="Value 1" />
        <menuitem label="Value 2" />
    </menupopup>
</menulist>

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.