Diff for /books/www/chapters/appc.html between versions 1.6 and 1.7

version 1.6, 2002/12/04 06:07:15 version 1.7, 2002/12/11 18:57:10
Line 1 Line 1
<HTML>    <h2>Appendix C</h2>
<HEAD><TITLE>Appendix C</TITLE></HEAD><BODY BGCOLOR=WHITE><H2>Appendix C</H2>    <h1><a name="77003"></a> Programmer's Reference</h1>
<H1><A NAME="77003"></A> Programmer's Reference</H1>    <p>This appendix is an easy-to-use reference that contains
<P>This appendix is an easy-to-use reference that contains information about XUL elements, XBL elements, and event attributes. Details about how     information about XUL elements, XBL elements, and event
each element and event works within a Mozilla application are covered in the rest of the book; to learn how to use XUL or XBL, read <    attributes. Details about how each element and event works
HREF="ch03.html#32764">Chapter 3</A> and <A HREF="ch07.html#70326">Chapter 7</A>.    within a Mozilla application are covered in the rest of the
<P>Once you know how to use XUL and XBL, this reference allows you to look up all available tags and elements quickly. Each entry listed below includes a brief description of the element or event, its purpose, what attributes the element or event has, and what other related elements or events you can look at to get more information.    book; to learn how to use XUL or XBL, read <a href=
<H2><A NAME="77004"></A> XUL Element Set</H2>    "ch03.html#32764">Chapter 3</a> and <a href=
<P>XUL isn't yet identified as a specification, and the  <!--INDEX STARTRANGE--XUL element set -->  <!--INDEX STARTRANGE--elements:XUL element set --> language is still changing. The elements and attributes given here represent a stable subset of the XUL widget set. XML allows you to define new elements and attributes arbitrarily (which is partly what makes a powerful extension like XBL possible) in your markup. Although it's discouraged in practice, Mozilla application developers-even those working on the Mozilla source itself-often use this flexibility to manage data in one-off attributes. For example, you may find XUL buttons in the source with attributes like "loading," which is not part of the XUL specification. In fact, XBL's presence, XML's flexibility, and DOM interfaces blur the distinction between valid XUL and other XML markup. This reference tries to document all widgets in the XUL 1.0 release, any additional attributes these elements have, and their use  <!--INDEX attributes:XUL:elements;XUL elements, attributes --> in Mozilla application development.    "ch07.html#70326">Chapter 7</a>.</p>
<P>All XUL elements have the attributes shown in Table C-1.    <p>Once you know how to use XUL and XBL, this reference allows
    you to look up all available tags and elements quickly. Each
<P><I>Table C-1: <A NAME="77002"></A></I>    entry listed below includes a brief description of the element
<I>Common XUL element attributes</I>    or event, its purpose, what attributes the element or event
<P><TABLE WIDTH=100% BORDER=1><TR><TD><B>  Attribute</B></TD> <TD><B>  Description</B></TD></TR>    has, and what other related elements or events you can look at
<TR><TD> align</TD>     <TD>  Specifies how child elements are aligned: baseline, center, end, start, or stretch</TD></TR>    to get more information.</p>
<TR><TD> allowevents</TD>     <TD>  (Boolean) Specifies whether events should be passed to the child elements</TD></TR>    <h2><a name="77004"></a> XUL Element Set</h2>
<TR><TD> class</TD>     <TD>  The element class of the ; often used for class-based style rules</TD></TR>    <p>XUL isn't yet identified as a specification, and the 
<TR><TD> collapsed</TD>     <TD>  (Boolean) Specifies whether the element is collapsed or displayed; defaults to false</TD></TR>    <!--INDEX STARTRANGE==XUL element set --> 
<TR><TD> container</TD>     <TD>  (Boolean) Specifies whether the element can have child elements</TD></TR>    <!--INDEX STARTRANGE==elements:XUL element set --> language is
<TR><TD> containment</TD>     <TD>  Used in templates; points to RDF property represented by this XUL element</TD></TR>    still changing. The elements and attributes given here
<TR><TD> context</TD>     <TD>  Points to the context menu that this element should use</TD></TR>    represent a stable subset of the XUL widget set. XML allows you
<TR><TD> datasources</TD>     <TD>  Used in templates; points to the RDF data that gets processed</TD></TR>    to define new elements and attributes arbitrarily (which is
<TR><TD> debug</TD>     <TD>  Used for debugging XUL; adds borders to make the element and its layout easily visible</TD></TR>    partly what makes a powerful extension like XBL possible) in
<TR><TD> dir</TD>     <TD>  Specifies the direction of the children: normal or reverse</TD></TR>    your markup. Although it's discouraged in practice, Mozilla
<TR><TD> empty</TD>     <TD>  (Boolean) Used for template; specifies that the container has no children</TD></TR>    application developers-even those working on the Mozilla source
<TR><TD> equalsize</TD>     <TD>  Specifies whether the children should be of the same size: always or never</TD></TR>    itself-often use this flexibility to manage data in one-off
<TR><TD> flex</TD>     <TD>  Provides an integer or percent value that specifies the flexibility of an element relative to its siblings within a container</TD></TR>    attributes. For example, you may find XUL buttons in the source
<TR><TD> flexgroup</TD>     <TD>  Provides an integer that can group elements and give them the same degree of flexibility</TD></TR>    with attributes like "loading," which is not part of the XUL
<TR><TD> height</TD>     <TD>  Specifies an element's height</TD></TR>    specification. In fact, XBL's presence, XML's flexibility, and
<TR><TD> hidden</TD>     <TD>  (Boolean) Specifies whether the element is displayed; defaults to </TD>false</TR>    DOM interfaces blur the distinction between valid XUL and other
<TR><TD> id</TD>     <TD>  A unique identifier for the element</TD></TR>    XML markup. This reference tries to document all widgets in the
<TR><TD> insertafter</TD>     <TD>  Names the ID of the element after which this element should be overlaid; this attribute works only in overlays</TD></TR>    XUL 1.0 release, any additional attributes these elements have,
<TR><TD> insertbefore</TD>     <TD>  Names the ID of the element which this element should be overlaid before; this attribute works only in overlays</TD></TR>    and their use 
<TR><TD> left</TD>     <TD>  Specifies an element's position within a container in pixels to the left</TD></TR>    <!--INDEX attributes:XUL:elements;XUL elements, attributes -->
<TR><TD> maxheight</TD>     <TD>  Specifies an element's maximum height</TD></TR>    in Mozilla application development.</p>
<TR><TD> maxwidth</TD>     <TD>  Specifies an element's maximum width</TD></TR>    <p>All XUL elements have the attributes shown in Table C-1.</p>
<TR><TD> minheight</TD>     <TD>  Specifies an element's minimum height</TD></TR>    <p><i>Table C-1: <a name="77002"></a></i> <i>Common XUL element
<TR><TD> minwidth</TD>     <TD>  Specifies an element's minimum width</TD></TR>    attributes</i></p>
<TR><TD> observes</TD>     <TD>  Points to a broadcasting element whose state this element observes</TD></TR>    false
<TR><TD> ordinal</TD>     <TD>  (Integer) Specifies the element's order within the parent</TD></TR>    <table width="100%" border="1">
<TR><TD> orient</TD>     <TD>  Shows the element's orientation: vertical or horizontal</TD></TR>      <tr>
<TR><TD> pack</TD>     <TD>  Shows how children should be distributed within this container: center, end, or start</TD></TR>        <td><b>Attribute</b></td>
<TR><TD> persist</TD>     <TD>  Shows which of the element's attributes should be persisted/stored for reuse</TD></TR>        <td><b>Description</b></td>
<TR><TD> position</TD>     <TD>  Shows the element's position within a list (e.g., menuitems in a menu)</TD></TR>      </tr>
<TR><TD> ref</TD>     <TD>  Specifies the RDF data root to begin processing (used in templates)</TD></TR>      <tr>
<TR><TD> style</TD>     <TD>  Provides style rules for the current element</TD></TR>        <td>align</td>
<TR><TD> template</TD>     <TD>  Specifies an existing template to use for this content (used in templates)</TD></TR>        <td>Specifies how child elements are aligned: baseline,
<TR><TD> tooltip</TD>     <TD>  Specifies a pop up or tooltip ID to be used for this element</TD></TR>        center, end, start, or stretch</td>
<TR><TD> tooltiptext</TD>     <TD>  Specifies text to be displayed in the element's tooltip (doesn't require a separate tooltip attribute)</TD></TR>      </tr>
<TR><TD> top</TD>     <TD>  Shows the current element's position within a container in pixels from the top</TD></TR>      <tr>
<TR><TD> uri</TD>     <TD>  Specifies the root in the XUL where content processing begins (used in templates)</TD></TR>        <td>allowevents</td>
<TR><TD> width</TD>     <TD>  Specifies an element's width</TD></TR></TABLE><P>        <td>(Boolean) Specifies whether events should be passed to
        the child elements</td>
<HR><H3><A NAME="77008"></A> action</H3>      </tr>
Child element in a XUL template structure that draws content for matched data      <tr>
<H4><A NAME="77008"></A> Additional Attributes</H4>        <td>class</td>
None.        <td>The element class of the ; often used for class-based
<H4><A NAME="77008"></A> Description</H4>        style rules</td>
The <TT> <!--INDEX action element, XUL --> action</TT> element defines the content drawn into the XUL when the rules defined in a template's <TT>conditions</TT> structure are met. The content to be drawn is an <TT>action</TT> element's child.      </tr>
<H4><A NAME="77008"></A> See Also</H4>      <tr>
<TT>template</TT>, <TT>rule</TT>, <TT>condition</TT>, <TT>binding</TT>        <td>collapsed</td>
<HR><H3><A NAME="77012"></A> arrowscrollbox</H3>        <td>(Boolean) Specifies whether the element is collapsed or
<P>Container box for scrolling contents        displayed; defaults to false</td>
<H4><A NAME="77012"></A> Additional Attributes</H4>      </tr>
None.      <tr>
<H4><A NAME="77012"></A> Description</H4>        <td>container</td>
A <TT>box</TT> with arrows  <!--INDEX arrowscrollbox element, XUL --> that allow scrolling through its contents. The box scrolls when the user's mouse hovers over the arrows. It is commonly used in large menus that overflow a provided space.        <td>(Boolean) Specifies whether the element can have child
<H4><A NAME="77012"></A> See Also</H4>        elements</td>
<TT>autorepeatbutton</TT>, <TT>scrollbox</TT>      </tr>
<HR><H3><A NAME="77016"></A> autorepeatbutton</H3>      <tr>
<P>Provides arrows for a scrolling area        <td>containment</td>
<H4><A NAME="77016"></A> Additional Attributes</H4>        <td>Used in templates; points to RDF property represented
scrolldir        by this XUL element</td>
<H4><A NAME="77016"></A> Description</H4>      </tr>
This element is used to  <!--INDEX autorepeatbutton element, XUL --> internally bind the <TT>arrowscrollbox</TT> element and it surrounds a <TT>scrollbox</TT> area to provide the navigation arrows. The <TT>scrolldir</TT> attribute, which can have a value of <TT>up</TT> or <TT>down</TT>, determines the direction of the arrows.      <tr>
<H4><A NAME="77016"></A> See Also</H4>        <td>context</td>
<TT>arrowscrollbox</TT>, <TT>scrollbox</TT>        <td>Points to the context menu that this element should
<HR><H3><A NAME="77020"></A> binding</H3>        use</td>
<P>Child element in a XUL template that optionally matches in the data      </tr>
<H4><A NAME="77020"></A> Additional Attributes</H4>      <tr>
<TT>predicate</TT>,  <!--INDEX binding element, XUL --> <TT>object</TT>, <TT>subject</TT>, <TT>template</TT>, <TT>rule</TT>, <TT>condition</TT>, <TT>action</TT>,<TT> bindings</TT>        <td>datasources</td>
<H4><A NAME="77020"></A> Description</H4>        <td>Used in templates; points to the RDF data that gets
In contrast to the <TT>rule</TT> element, which must match to trigger the action, <TT>binding</TT> allows you to create an optional rule for data matching.        processed</td>
<H4><A NAME="77020"></A> See Also</H4>      </tr>
<TT>action</TT>, <TT>template</TT>, <TT>rule</TT>, <TT>condition</TT>, <TT>bindings</TT>      <tr>
<HR><H3><A NAME="77024"></A> bindings</H3>        <td>debug</td>
<P>Substructure in a XUL template that collects the optional binding rules        <td>Used for debugging XUL; adds borders to make the
Additional Attributes        element and its layout easily visible</td>
None.      </tr>
<H4><A NAME="77024"></A> Description</H4>      <tr>
Individual bindings must be  <!--INDEX bindings element, XUL --> defined with a <TT>bindings</TT> parent to be a part of a valid XUL template.        <td>dir</td>
<H4><A NAME="77024"></A> See Also</H4>        <td>Specifies the direction of the children: normal or
<TT>action</TT>, <TT>template</TT>, <TT>rule</TT>, <TT>condition</TT>, <TT>binding</TT>        reverse</td>
<HR><H3><A NAME="77028"></A> box</H3>      </tr>
<P>Generic container and layout element      <tr>
<H4><A NAME="77028"></A> Additional Attributes</H4>        <td>empty</td>
None.        <td>(Boolean) Used for template; specifies that the
<H4><A NAME="77028"></A> Description</H4>        container has no children</td>
This element can contain any  <!--INDEX box element, XUL --> type of content and any number of elements. Its default orientation is <TT>horizontal</TT>, unless otherwise overridden by the <TT>orient</TT> attribute, and the contents are laid out in the order they appear in the file. The <TT>box</TT> is the basic layout unit in a XUL interface. Many, if not most, XUL elements inherit from <TT>box</TT>.      </tr>
<H4><A NAME="77028"></A> See Also</H4>      <tr>
<TT>hbox</TT>, <TT>vbox</TT>        <td>equalsize</td>
<HR><H3>broadcaster</H3>        <td>Specifies whether the children should be of the same
<P>Notifies elements when a change occurs in the UI        size: always or never</td>
Contained by      </tr>
broadcasterset      <tr>
<H4><A NAME="77033"></A> Additional Attributes</H4>        <td>flex</td>
<TT>checked</TT>, <TT>accesskey</TT>, <TT>oncommand</TT>, <TT>value</TT>, <TT>label</TT>, <TT>disabled</TT>        <td>Provides an integer or percent value that specifies the
<H4><A NAME="77033"></A> Description</H4>        flexibility of an element relative to its siblings within a
A <TT>broadcaster</TT> acts as a host for  <!--INDEX broadcaster element, XUL --> other elements, detecting changes that occur in the UI and notifying those elements of the changes via attribute changes. The elements that use it are said to observe the broadcaster. The observed attribute is typically the <TT>oncommand</TT> attribute, but can be any attribute.        container</td>
<H4><A NAME="77033"></A> See Also</H4>      </tr>
<TT>broadcasterset</TT>, <TT>command</TT>, <TT>observes</TT>      <tr>
<HR><H3><A NAME="77038"></A> broadcasterset</H3>        <td>flexgroup</td>
<P>Container for broadcaster elements        <td>Provides an integer that can group elements and give
<A NAME="77038"></A> Contains        them the same degree of flexibility</td>
broadcaster      </tr>
<H4><A NAME="77038"></A> Additional Attributes</H4>      <tr>
None.        <td>height</td>
<H4><A NAME="77038"></A> Description</H4>        <td>Specifies an element's height</td>
The purpose of this nonvisible  <!--INDEX broadcasterset element, XUL --> element is to group a set of broadcasters logically. The XUL document can contain one or multiple sets.      </tr>
<H4><A NAME="77038"></A> See Also</H4>      <tr>
<TT>broadcaster</TT>, <TT>commandset</TT>        <td>hidden</td>
<HR><H3><A NAME="77042"></A> browser</H3>        <td>(Boolean) Specifies whether the element is displayed;
<P>Web-content container        defaults to</td>
<H4><A NAME="77042"></A> Additional Attributes</H4>      </tr>
<TT>src</TT>, <TT>name</TT>, <TT>content</TT>, <TT>onclick</TT>, <TT>type</TT>, <TT>disablehistory</TT>,<TT> disablesecurity</TT>      <tr>
<H4><A NAME="77042"></A> Description</H4>        <td>id</td>
A content widget or frame used  <!--INDEX browser element, XUL --> to load in web content for read-only viewing. This element is used by the main Mozilla browser, so it handles HTML, XML, and plain text. To load a page, set the <TT>src</TT> attribute to a URL. Other features include the attachment of a context menu that uses the <TT>context</TT> attribute and various methods and properties exposed for web navigation and display.        <td>A unique identifier for the element</td>
<H4><A NAME="77042"></A> See Also</H4>      </tr>
<TT>editor</TT>, <TT>iframe</TT>      <tr>
<HR><H3><A NAME="77046"></A> button</H3>        <td>insertafter</td>
<P>A widget that activates some functionality when pressed        <td>Names the ID of the element after which this element
<H4><A NAME="77046"></A> Additional Attributes</H4>        should be overlaid; this attribute works only in
<TT>accesskey</TT>, <TT>dir</TT>, <TT>disabled</TT>, <TT>dlgType</TT>, <TT>group</TT>, <TT>image</TT>, <TT>label</TT>, <TT>orient</TT>, <TT>type</TT>, <TT>value</TT>        overlays</td>
<H4><A NAME="77046"></A> Description</H4>      </tr>
A <TT>button</TT> typically gives the user  <!--INDEX button element, XUL --> an option to click it to carry out JavaScript code routine(s). This code can be a function call or inline script and is contained in the <TT>onclick</TT> attribute or the <TT>oncommand</TT> event handler. It can optionally have an image associated with a URL contained in the <TT>image</TT> attribute or by using the <TT>list-style-image</TT> CSS property. There are various types of buttons, determined by the type attribute, including <TT>checkbox</TT>, <TT>menu</TT>, <TT>menu-button</TT>, and <TT>radio</TT>. Leave this out for a normal button.      <tr>
<H4><A NAME="77046"></A> See Also</H4>        <td>insertbefore</td>
<TT>autorepeatbutton</TT>, <TT>toolbarbutton</TT>        <td>Names the ID of the element which this element should
<HR><H3><A NAME="77051"></A> caption</H3>        be overlaid before; this attribute works only in
<P>Provides heading for a groupbox element        overlays</td>
<A NAME="77051"></A> Contained by      </tr>
<TT>groupbox</TT>,  <!--INDEX caption element, XUL --> radiogroup      <tr>
<H4><A NAME="77051"></A> Additional Attributes</H4>        <td>left</td>
None.        <td>Specifies an element's position within a container in
<H4><A NAME="77051"></A> Description</H4>        pixels to the left</td>
This element is most commonly used to provide a text label for a <TT>groupbox</TT> by setting the <TT>label</TT> attribute. However, it is flexible about other content it can contain, such as checkboxes or radio buttons.      </tr>
<H4><A NAME="77051"></A> See Also</H4>      <tr>
<TT>description</TT>, <TT>groupbox</TT>, <TT>label</TT>, <TT>radiogroup</TT>        <td>maxheight</td>
<HR><H3><A NAME="77055"></A> checkbox</H3>        <td>Specifies an element's maximum height</td>
<P>Indicates a specified feature's on/off state      </tr>
<H4><A NAME="77055"></A> Additional Attributes</H4>      <tr>
<TT>accesskey</TT>, <TT>label</TT>, <TT>checked</TT>        <td>maxwidth</td>
<H4><A NAME="77055"></A> Description</H4>        <td>Specifies an element's maximum width</td>
A <TT>checkbox</TT> appears as a small  <!--INDEX checkbox element, XUL --> box that can be checked on or off. When checked on or off, the <TT>checked</TT> attribute is set to <TT>true</TT> or <TT>false</TT>. It can be set initially for a default value. To associate text with a <TT>checkbox</TT>, set the <TT>label</TT> attribute.      </tr>
<H4><A NAME="77055"></A> See Also</H4>      <tr>
radio        <td>minheight</td>
<HR><H3>colorpicker</H3>        <td>Specifies an element's minimum height</td>
<P>Widget used to choose a color      </tr>
Additional Attributes      <tr>
<TT>onchange</TT>, <TT> <!--INDEX colorpicker element, XUL --> type</TT>, <TT>id</TT>, <TT>palettename</TT>        <td>minwidth</td>
<H4><A NAME="77059"></A> Description</H4>        <td>Specifies an element's minimum width</td>
When activated, this widget presents a choice of colors to the user in a grid format. The user selects a color by clicking on it. The <TT>palettename</TT> attribute determines the displayed colors. Three values for this attribute represent three types of palettes: standard, grey, and web.      </tr>
<H4><A NAME="77059"></A> JavaScript Methods and Properties</H4>      <tr>
color        <td>observes</td>
<HR><H3><A NAME="77064"></A> column</H3>        <td>Points to a broadcasting element whose state this
<P>A column in a grid        element observes</td>
<A NAME="77064"></A> Contained by      </tr>
columns <!--INDEX column element, XUL -->      <tr>
<H4><A NAME="77064"></A> Additional Attributes</H4>        <td>ordinal</td>
None.        <td>(Integer) Specifies the element's order within the
<H4><A NAME="77064"></A> Description</H4>        parent</td>
<TT>column</TT> is a column entry in a <TT>grid</TT>, of which there can be one or more contained in a <TT>columns</TT> element. The content of cells in a column is determined by the children of each <TT>row</TT> element.      </tr>
<H4><A NAME="77064"></A> See Also</H4>      <tr>
<TT>columns</TT>, <TT>grid</TT>, <TT>row</TT>, <TT>rows</TT>        <td>orient</td>
<HR><H3><A NAME="77069"></A> columns</H3>        <td>Shows the element's orientation: vertical or
<P>Container for the number of columns in a grid        horizontal</td>
<A NAME="77069"></A> Contains      </tr>
column <!--INDEX columns element, XUL -->      <tr>
<H4><A NAME="77069"></A> Additional Attributes</H4>        <td>pack</td>
None.        <td>Shows how children should be distributed within this
<H4><A NAME="77069"></A> Description</H4>        container: center, end, or start</td>
The children of this element are one or more <TT>column</TT> elements, the number of which determines the actual number of grid columns.      </tr>
<H4><A NAME="77069"></A> See Also</H4>      <tr>
<TT>column</TT>, <TT>grid</TT>, <TT>row</TT>, <TT>rows</TT>        <td>persist</td>
<HR><H3>command</H3>        <td>Shows which of the element's attributes should be
<P>Defines functionality that can be called from multiple sources        persisted/stored for reuse</td>
Contained by      </tr>
commandset <!--INDEX command element, XUL -->      <tr>
<H4><A NAME="77074"></A> Additional Attributes</H4>        <td>position</td>
<TT>disabled</TT>, <TT>accesskey</TT>, <TT>observes</TT>, <TT>label</TT>, <TT>checked</TT>        <td>Shows the element's position within a list (e.g.,
<H4><A NAME="77074"></A> Description</H4>        menuitems in a menu)</td>
The <TT>command</TT> element provides a place to organize functionality used in more than one place in the interface-from a context menu, a keyboard shortcut, and a regular menu, for example. The element is identified and shared by using its <TT>ID</TT> value and an interested element's (i.e., a menu that wants the command) <TT>observes</TT> attribute. It also typically calls a JavaScript command from its <TT>oncommand</TT> event handler.      </tr>
<H4><A NAME="77074"></A> See Also</H4>      <tr>
<TT>commands</TT>, <TT>commandset</TT>        <td>ref</td>
<HR><H3><A NAME="77078"></A> commands</H3>        <td>Specifies the RDF data root to begin processing (used
<P>Container for a group of command sets        in templates)</td>
<H4><A NAME="77078"></A> Additional Attributes</H4>      </tr>
None. <!--INDEX commands element, XUL -->      <tr>
<H4><A NAME="77078"></A> Description</H4>        <td>style</td>
<TT>commandsets</TT> no longer need to be contained within a <TT>commands</TT> element. Still, the <TT>commands</TT> group can help you organize your code and user overlays to import commands, especially related sets.        <td>Provides style rules for the current element</td>
<H4><A NAME="77078"></A> See Also</H4>      </tr>
<TT>command</TT>, <TT>commandset</TT>      <tr>
<HR><H3><A NAME="77083"></A> commandset</H3>        <td>template</td>
<P>A container for multiple command elements        <td>Specifies an existing template to use for this content
<A NAME="77083"></A> Contains        (used in templates)</td>
command      </tr>
<H4><A NAME="77083"></A> Additional Attributes</H4>      <tr>
<TT>oncommandupdate</TT>,  <!--INDEX commandset element, XUL --> <TT>commandupdater</TT>, <TT>events</TT>        <td>tooltip</td>
<H4><A NAME="77083"></A> Description</H4>        <td>Specifies a pop up or tooltip ID to be used for this
An invisible, document-level element that acts as a logical grouping for commands or other command sets.        element</td>
<H4><A NAME="77083"></A> See Also</H4>      </tr>
<TT>command</TT>, <TT>commands</TT>      <tr>
<HR><H3><A NAME="77088"></A> conditions</H3>        <td>tooltiptext</td>
<P>Defines the conditions within a template rule        <td>Specifies text to be displayed in the element's tooltip
<A NAME="77088"></A> Contains        (doesn't require a separate tooltip attribute)</td>
<TT>content</TT>, <TT>member</TT>, triple <!--INDEX conditions element, XUL -->      </tr>
<H4><A NAME="77088"></A> Additional Attributes</H4>      <tr>
None.        <td>top</td>
<H4><A NAME="77088"></A> Description</H4>        <td>Shows the current element's position within a container
Within a <TT>template</TT>, the <TT>conditions</TT>, <TT>action</TT>, and sometimes the <TT>bindings</TT> elements comprise a single rule. The children of the <TT>conditions</TT> element must be matched to the processed data for that rule's action to make content.        in pixels from the top</td>
<H4><A NAME="77088"></A> See Also</H4>      </tr>
<TT>template</TT>, <TT>rule</TT>, <TT>action</TT>, <TT>member</TT>, <TT>triple</TT>, <TT>content</TT>      <tr>
<HR><H3><A NAME="77093"></A> content</H3>        <td>uri</td>
<P>Binds variables in a template        <td>Specifies the root in the XUL where content processing
<A NAME="77093"></A> Contained by        begins (used in templates)</td>
conditions <!--INDEX conditions element, XUL -->      </tr>
<H4><A NAME="77093"></A> Additional Attributes</H4>      <tr>
None.        <td>width</td>
<H4><A NAME="77093"></A> Description</H4>        <td>Specifies an element's width</td>
The <TT>content</TT> element is the portion of a template's <TT>conditions</TT> element that associates a variable, often representing a URI (e.g., <TT>&lt;content uri="?uri"/&gt;</TT>) with the data.      </tr>
<H4><A NAME="77093"></A> See Also</H4>    </table>
<TT>template</TT>, <TT>rule</TT>, <TT>action</TT>, <TT>conditions</TT>, <TT>member</TT>, <TT>triple</TT>    <hr>
<HR><H3>deck</H3>    <h3><a name="77008"></a> action</h3>
<P>Box container that displays one child element at a time    Child element in a XUL template structure that draws content
Additional Attributes    for matched data 
selectedIndex    <h4><a name="77008"></a> Additional Attributes</h4>
<H4><A NAME="77097"></A> Description</H4>    None. 
<TT>deck</TT> uses the attribute <TT>selectedIndex</TT>  <!--INDEX deck element, XUL --> to determine which child element to display. The others are hidden until they are displayed by index. <TT>deck</TT> is often used dynamically via the DOM to cycle through child elements, such as buttons.    <h4><a name="77008"></a> Description</h4>
<H4><A NAME="77097"></A> See Also</H4>    The <tt><!--INDEX action element, XUL --> action</tt> element
stack    defines the content drawn into the XUL when the rules defined
<HR><H3><A NAME="77101"></A> description</H3>    in a template's <tt>conditions</tt> structure are met. The
<P>Holder for block of text that can wrap to multiple lines    content to be drawn is an <tt>action</tt> element's child. 
<H4><A NAME="77101"></A> Additional Attributes</H4>    <h4><a name="77008"></a> See Also</h4>
<TT>crop</TT>, <TT>onmouseover</TT>,  <!--INDEX description element, XUL --> <TT>onmouseout</TT>, <TT>value</TT>    <tt>template</tt>, <tt>rule</tt>, <tt>condition</tt>,
<H4><A NAME="77101"></A> Description</H4>    <tt>binding</tt> 
The <TT>description</TT> element replaces <TT>&lt;html:label&gt;</TT> and other HTML-namespaced elements to wrap text in XUL interfaces. Text in a <TT>description</TT> can be defined as content with the open and close tags or provided in the <TT>value</TT> attribute. Note that the text does not wrap when placed in the <TT>value</TT> attribute.    <hr>
<H4><A NAME="77101"></A> See Also</H4>    <h3><a name="77012"></a> arrowscrollbox</h3>
<TT>caption</TT>, <TT>label</TT>    <p>Container box for scrolling contents</p>
<HR><H3><A NAME="77105"></A> dialog</H3>    <h4><a name="77012"></a> Additional Attributes</h4>
<P>Root element for secondary XUL window    None. 
<H4><A NAME="77105"></A> Additional Attributes</H4>    <h4><a name="77012"></a> Description</h4>
<TT>ondialogaccept</TT>, <TT>ondialogcancel</TT>, <TT>ondialoghelp</TT>, <TT>onunload</TT>, <TT>onload</TT>,<TT> title</TT>, <TT>buttons</TT>, <TT>windowtype</TT>, p<TT>ersist</TT>, <TT>y</TT>, <TT>x</TT>, <TT>screenY</TT>, <TT>screenX</TT>    A <tt>box</tt> with arrows 
<H4><A NAME="77105"></A> Description</H4>    <!--INDEX arrowscrollbox element, XUL --> that allow scrolling
<TT>dialog</TT> is a version of the <TT>window</TT> element  <!--INDEX dialog element, XUL --> built for displaying a secondary dialog window in the application. Like <TT>window</TT>, <TT>dialog</TT> is the root element in a XUL file. Event handlers such as <TT>ondialogaccept</TT> and <TT>ondialogcancel</TT> are included as conveniences for handling user input.    through its contents. The box scrolls when the user's mouse
<H4><A NAME="77105"></A> See Also</H4>    hovers over the arrows. It is commonly used in large menus that
<TT>window</TT>, <TT>page</TT>    overflow a provided space. 
<HR><H3><A NAME="77110"></A> dialogheader</H3>    <h4><a name="77012"></a> See Also</h4>
<P>Styled text heading for UI panel    <tt>autorepeatbutton</tt>, <tt>scrollbox</tt> 
<A NAME="77110"></A> Contained by    <hr>
dialog    <h3><a name="77016"></a> autorepeatbutton</h3>
<H4><A NAME="77110"></A> Additional Attributes</H4>    <p>Provides arrows for a scrolling area</p>
<TT>title</TT>,  <!--INDEX dialogheader element, XUL --> description    <h4><a name="77016"></a> Additional Attributes</h4>
<H4><A NAME="77110"></A> Description</H4>    scrolldir 
This is a formatted horizontal panel that contains text specified by the <TT>title</TT> attribute. This element is the heading that appears at the top of the right panel in the Mozilla global preferences dialog.    <h4><a name="77016"></a> Description</h4>
<H4><A NAME="77110"></A> See Also</H4>    This element is used to 
<TT>window</TT>, <TT>dialog</TT>    <!--INDEX autorepeatbutton element, XUL --> internally bind the
<HR><H3><A NAME="77115"></A> editor</H3>    <tt>arrowscrollbox</tt> element and it surrounds a
<P>Content area for editable web content    <tt>scrollbox</tt> area to provide the navigation arrows. The
<H4><A NAME="77115"></A> Additional Attributes</H4>    <tt>scrolldir</tt> attribute, which can have a value of
src <!--INDEX editor element, XUL -->    <tt>up</tt> or <tt>down</tt>, determines the direction of the
<H4><A NAME="77115"></A> Description</H4>    arrows. 
This high-level widget edits text and HTML. <TT>contentDocument</TT> is a reference to the document contained within the editor.    <h4><a name="77016"></a> See Also</h4>
<H4><A NAME="77115"></A> JavaScript Methods and Properties</H4>    <tt>arrowscrollbox</tt>, <tt>scrollbox</tt> 
contentDocument    <hr>
<H4><A NAME="77115"></A> See Also</H4>    <h3><a name="77020"></a> binding</h3>
<TT>browser</TT>, <TT>iframe</TT>    <p>Child element in a XUL template that optionally matches in
<HR><H3><A NAME="77120"></A> grid</H3>    the data</p>
<P>Widget for laying out content in a structured tabular fashion    <h4><a name="77020"></a> Additional Attributes</h4>
<A NAME="77120"></A> Contains    <tt>predicate</tt>, <!--INDEX binding element, XUL -->
<TT>rows</TT>, <TT>columns</TT>    <tt>object</tt>, <tt>subject</tt>, <tt>template</tt>,
<H4><A NAME="77120"></A> Additional Attributes</H4>    <tt>rule</tt>, <tt>condition</tt>, <tt>action</tt>,
None.    <tt>bindings</tt> 
<H4><A NAME="77120"></A> Description</H4>    <h4><a name="77020"></a> Description</h4>
The number of column elements  <!--INDEX grid element, XUL --> that are placed in rows determines the number of columns and the content for each row is placed in the <TT>row</TT> element. The number of row children must correspond to the number of columns.    In contrast to the <tt>rule</tt> element, which must match to
<H4><A NAME="77120"></A> See Also</H4>    trigger the action, <tt>binding</tt> allows you to create an
<TT>column</TT>, <TT>columns</TT>, <TT>listbox</TT>, <TT>row</TT>, <TT>rows</TT>, <TT>tree</TT>    optional rule for data matching. 
<HR><H3><A NAME="77124"></A> grippy</H3>    <h4><a name="77020"></a> See Also</h4>
<P>Visible widget used on a grippy bar to expand or collapse a UI region    <tt>action</tt>, <tt>template</tt>, <tt>rule</tt>,
<A NAME="77124"></A> Contained by    <tt>condition</tt>, <tt>bindings</tt> 
splitter <!--INDEX grippy element, XUL -->    <hr>
<H4><A NAME="77124"></A> Additional Attributes</H4>    <h3><a name="77024"></a> bindings</h3>
None.    <p>Substructure in a XUL template that collects the optional
<H4><A NAME="77124"></A> Description</H4>    binding rules Additional Attributes None.</p>
<TT>grippy</TT> appears as a child of a <TT>splitter</TT> and provides the little "handle" that opens and closes the <TT>sidebar</TT> and other collapsible elements in the interface.    <h4><a name="77024"></a> Description</h4>
<HR><H3><A NAME="77129"></A> groupbox</H3>    Individual bindings must be <!--INDEX bindings element, XUL -->
<P>Box with frame surrounding it    defined with a <tt>bindings</tt> parent to be a part of a valid
<A NAME="77129"></A> Contains    XUL template. 
caption <!--INDEX groupbox element, XUL -->    <h4><a name="77024"></a> See Also</h4>
<H4><A NAME="77129"></A> Additional Attributes</H4>    <tt>action</tt>, <tt>template</tt>, <tt>rule</tt>,
None.    <tt>condition</tt>, <tt>binding</tt> 
<H4><A NAME="77129"></A> Description</H4>    <hr>
The border that appears around and organizes elements in the interface (e.g., in dialogs where selectable elements are grouped together); often comes from a <TT>groupbox</TT> parent.    <h3><a name="77028"></a> box</h3>
<H4><A NAME="77129"></A> See Also</H4>    <p>Generic container and layout element</p>
box    <h4><a name="77028"></a> Additional Attributes</h4>
<HR><H3><A NAME="77133"></A> hbox</H3>    None. 
<P>Box container whose children are laid out horizontally    <h4><a name="77028"></a> Description</h4>
<H4><A NAME="77133"></A> Additional Attributes</H4>    This element can contain any <!--INDEX box element, XUL -->
None. <!--INDEX hbox element, XUL -->    type of content and any number of elements. Its default
<H4><A NAME="77133"></A> Description</H4>    orientation is <tt>horizontal</tt>, unless otherwise overridden
The <TT>hbox</TT> element is a shorthand for <TT>&lt;box orient="horizontal"&gt;</TT>. It is the preferred way to achieve horizontal orientation in box layout.    by the <tt>orient</tt> attribute, and the contents are laid out
<H4><A NAME="77133"></A> See Also</H4>    in the order they appear in the file. The <tt>box</tt> is the
<TT>box</TT>, <TT>vbox</TT>    basic layout unit in a XUL interface. Many, if not most, XUL
<HR><H3><A NAME="77137"></A> iframe</H3>    elements inherit from <tt>box</tt>. 
<P>Web content area    <h4><a name="77028"></a> See Also</h4>
<H4><A NAME="77137"></A> Additional Attributes</H4>    <tt>hbox</tt>, <tt>vbox</tt> 
<TT>name</TT>, <TT>src</TT>, <TT>type</TT>    <hr>
<H4><A NAME="77137"></A> Description</H4>    <h3>broadcaster</h3>
Like <TT>browser</TT>, <TT>iframe</TT> allows you to  <!--INDEX iframe element, XUL --> display web content, XML, and other data using the <TT>src</TT> attribute, but has less intrinsic browsing functionality available (such as browser history). You can use any number of iframes in a document.    <p>Notifies elements when a change occurs in the UI Contained
<H4><A NAME="77137"></A> See Also</H4>    by broadcasterset</p>
<TT>browser</TT>, <TT>editor</TT>    <h4><a name="77033"></a> Additional Attributes</h4>
<HR><H3><A NAME="77140"></A> image</H3>    <tt>checked</tt>, <tt>accesskey</tt>, <tt>oncommand</tt>,
<P>Display of a supported type image    <tt>value</tt>, <tt>label</tt>, <tt>disabled</tt> 
<H4><A NAME="77140"></A> Additional Attributes</H4>    <h4><a name="77033"></a> Description</h4>
src    A <tt>broadcaster</tt> acts as a host for 
<H4><A NAME="77140"></A> Description</H4>    <!--INDEX broadcaster element, XUL --> other elements,
The XUL image is analogous to the  <!--INDEX image element, XUL --> HTML <TT>&lt;img&gt;</TT> element. The supported types in Gecko are PNG, JPG, GIF, and BMP.    detecting changes that occur in the UI and notifying those
<HR><H3><A NAME="77145"></A> key</H3>    elements of the changes via attribute changes. The elements
<P>Definition for a keyboard shortcut    that use it are said to observe the broadcaster. The observed
<A NAME="77145"></A> Contained by    attribute is typically the <tt>oncommand</tt> attribute, but
keyset <!--INDEX key element, XUL -->    can be any attribute. 
<H4><A NAME="77145"></A> Additional Attributes</H4>    <h4><a name="77033"></a> See Also</h4>
<TT>modifiers</TT>, <TT>command</TT>, <TT>key</TT> , <TT>keycode</TT>, <TT>observes</TT>    <tt>broadcasterset</tt>, <tt>command</tt>, <tt>observes</tt> 
<H4><A NAME="77145"></A> Description</H4>    <hr>
A <TT>key</TT> is often defined with a <TT>commandkey</TT> and a modifier (e.g., <TT>P</TT> + <TT>Ctrl</TT>), and uses an <TT>oncommand</TT> event handler to fire the given command when invoked.    <h3><a name="77038"></a> broadcasterset</h3>
<H4><A NAME="77145"></A> See Also</H4>    <p>Container for broadcaster elements <a name="77038"></a>
keyset    Contains broadcaster</p>
<HR><H3><A NAME="77150"></A> keybinding</H3>    <h4><a name="77038"></a> Additional Attributes</h4>
<P>Container for a keyset or group of keysets    None. 
<A NAME="77150"></A> Contains    <h4><a name="77038"></a> Description</h4>
keyset <!--INDEX keybinding element, XUL -->    The purpose of this nonvisible 
<H4><A NAME="77150"></A> Additional Attributes</H4>    <!--INDEX broadcasterset element, XUL --> element is to group a
None.    set of broadcasters logically. The XUL document can contain one
<H4><A NAME="77150"></A> Description</H4>    or multiple sets. 
This element is used in an overlaid file to contain a group of platform-specific key sets. It uses the <TT>ID</TT> attribute to overlay itself into XUL files that pick up sets of key bindings.    <h4><a name="77038"></a> See Also</h4>
<H4><A NAME="77150"></A> See Also</H4>    <tt>broadcaster</tt>, <tt>commandset</tt> 
<TT>key</TT>, <TT>keyset</TT>    <hr>
<HR><H3><A NAME="77154"></A> keyset</H3>    <h3><a name="77042"></a> browser</h3>
<P>Container for one or more key elements    <p>Web-content container</p>
Contains    <h4><a name="77042"></a> Additional Attributes</h4>
key <!--INDEX keyset element, XUL -->    <tt>src</tt>, <tt>name</tt>, <tt>content</tt>,
<H4><A NAME="77154"></A> Additional Attributes</H4>    <tt>onclick</tt>, <tt>type</tt>, <tt>disablehistory</tt>,
None.    <tt>disablesecurity</tt> 
<H4><A NAME="77154"></A> Description</H4>    <h4><a name="77042"></a> Description</h4>
<TT>key</TT> elements no longer need to be contained within a <TT>keyset</TT> parent. Still, keysets can help organize groups of keys-particularly related ones.    A content widget or frame used 
<H4><A NAME="77154"></A> See Also</H4>    <!--INDEX browser element, XUL --> to load in web content for
<TT>key</TT>, <TT>keybinding</TT>    read-only viewing. This element is used by the main Mozilla
<HR><H3><A NAME="77158"></A> label</H3>    browser, so it handles HTML, XML, and plain text. To load a
<P>Simple text display element and label for a control element    page, set the <tt>src</tt> attribute to a URL. Other features
<H4><A NAME="77158"></A> Additional Attributes</H4>    include the attachment of a context menu that uses the
<TT>control</TT>, <TT>for</TT>, <TT>accesskey</TT>, <TT>crop</TT>,  <!--INDEX label element, XUL --> <TT>value</TT>    <tt>context</tt> attribute and various methods and properties
<H4><A NAME="77158"></A> Description</H4>    exposed for web navigation and display. 
This text element can just display text in the UI. Unlike the <TT>description</TT> element, the text will not wrap. If you use it with a control element (the association occurs through the <TT>for</TT> attribute, the value of which must match the element's <TT>id</TT>) such as a <TT>textbox</TT>, the focus moves to the control element when the <TT>label</TT> is clicked.    <h4><a name="77042"></a> See Also</h4>
<H4><A NAME="77158"></A> See Also</H4>    <tt>editor</tt>, <tt>iframe</tt> 
<TT>caption</TT>, <TT>description</TT>    <hr>
<HR><H3><A NAME="77162"></A> listbox</H3>    <h3><a name="77046"></a> button</h3>
<P>Used for display of a flat list of items    <p>A widget that activates some functionality when pressed</p>
<H4><A NAME="77162"></A> Additional Attributes</H4>    <h4><a name="77046"></a> Additional Attributes</h4>
<TT>datasources</TT>, <TT>sortResource</TT>, <TT> <!--INDEX listbox element, XUL --> sortDirection</TT>, <TT>rows</TT>, <TT>seltype</TT>, <TT>ref</TT>    <tt>accesskey</tt>, <tt>dir</tt>, <tt>disabled</tt>,
<H4><A NAME="77162"></A> Description</H4>    <tt>dlgType</tt>, <tt>group</tt>, <tt>image</tt>,
<TT>listbox</TT> is a lightweight tabular display widget. Unlike <TT>tree</TT>, it cannot handle nested rows. It does support multiple columns, however. It is easy to use and renders content very quickly.    <tt>label</tt>, <tt>orient</tt>, <tt>type</tt>, <tt>value</tt> 
<H4><A NAME="77162"></A> See Also</H4>    <h4><a name="77046"></a> Description</h4>
<TT>listcell</TT>, <TT>listcol</TT>, <TT>listcols</TT>, <TT>listhead</TT>, <TT>listheader</TT>, <TT>listitem</TT>    A <tt>button</tt> typically gives the user 
<HR><H3><A NAME="77167"></A> listcell</H3>    <!--INDEX button element, XUL --> an option to click it to
<P>Single cell of a listbox    carry out JavaScript code routine(s). This code can be a
<A NAME="77167"></A> Contained by    function call or inline script and is contained in the
listitem <!--INDEX listcell element, XUL -->    <tt>onclick</tt> attribute or the <tt>oncommand</tt> event
<H4><A NAME="77167"></A> Additional Attributes</H4>    handler. It can optionally have an image associated with a URL
<TT>label</TT>, <TT>flexlabel</TT>, <TT>crop</TT>, <TT>disabled</TT>, <TT>image</TT>, <TT>checked</TT>    contained in the <tt>image</tt> attribute or by using the
<H4><A NAME="77167"></A> Description</H4>    <tt>list-style-image</tt> CSS property. There are various types
The <TT>listcell</TT> is the element within a <TT>listbox</TT> that actually displays data.    of buttons, determined by the type attribute, including
<H4><A NAME="77167"></A> See Also</H4>    <tt>checkbox</tt>, <tt>menu</tt>, <tt>menu-button</tt>, and
<TT>listbox</TT>, <TT>listcol</TT>, <TT>listcols</TT>, <TT>listheader</TT>, <TT>listitem</TT>    <tt>radio</tt>. Leave this out for a normal button. 
<HR><H3>listcol</H3>    <h4><a name="77046"></a> See Also</h4>
<P>Listbox column definition    <tt>autorepeatbutton</tt>, <tt>toolbarbutton</tt> 
<A NAME="77171"></A> Contained by    <hr>
listcols <!--INDEX listcol element, XUL -->    <h3><a name="77051"></a> caption</h3>
<H4><A NAME="77171"></A> Description</H4>    <p>Provides heading for a groupbox element <a name="77051"></a>
This element represents a column in a <TT>listbox</TT>.    Contained by <tt>groupbox</tt>, 
<H4><A NAME="77171"></A> See Also</H4>    <!--INDEX caption element, XUL --> radiogroup</p>
<TT>listbox</TT>, <TT>listcell</TT>, <TT>listcols</TT>, <TT>listheader</TT>, <TT>listitem</TT>    <h4><a name="77051"></a> Additional Attributes</h4>
<HR><H3><A NAME="77176"></A> listcols</H3>    None. 
<P>Container for listbox columns (listcol)    <h4><a name="77051"></a> Description</h4>
<A NAME="77176"></A> Contained by    This element is most commonly used to provide a text label for
listbox <!--INDEX listcols element, XUL -->    a <tt>groupbox</tt> by setting the <tt>label</tt> attribute.
<A NAME="77176"></A> Contains    However, it is flexible about other content it can contain,
listcol    such as checkboxes or radio buttons. 
<H4><A NAME="77176"></A> Description</H4>    <h4><a name="77051"></a> See Also</h4>
This element contains any number of individual <TT>listbox</TT> columns.    <tt>description</tt>, <tt>groupbox</tt>, <tt>label</tt>,
<H4><A NAME="77176"></A> See Also</H4>    <tt>radiogroup</tt> 
<TT>listbox</TT>, <TT>listcell</TT>, <TT>listcol</TT>, <TT>listheader</TT>, <TT>listitem</TT>    <hr>
<HR><H3><A NAME="77181"></A> listhead</H3>    <h3><a name="77055"></a> checkbox</h3>
<P>Container for column header in list boxes (listheader)    <p>Indicates a specified feature's on/off state</p>
<A NAME="77181"></A> Contained by    <h4><a name="77055"></a> Additional Attributes</h4>
listbox <!--INDEX listhead element, XUL -->    <tt>accesskey</tt>, <tt>label</tt>, <tt>checked</tt> 
<A NAME="77181"></A> Contains    <h4><a name="77055"></a> Description</h4>
listheader    A <tt>checkbox</tt> appears as a small 
<H4><A NAME="77181"></A> Description</H4>    <!--INDEX checkbox element, XUL --> box that can be checked on
The <TT>listhead</TT> element is analogous to the HTML <TT>thead</TT> element, and contains the header cells for an XUL listbox table.    or off. When checked on or off, the <tt>checked</tt> attribute
<H4><A NAME="77181"></A> See Also</H4>    is set to <tt>true</tt> or <tt>false</tt>. It can be set
<TT>listbox</TT>, <TT>listcell</TT>, <TT>listcol, listcols</TT>, <TT>listheader</TT>, <TT>listitem</TT>    initially for a default value. To associate text with a
<HR><H3><A NAME="77186"></A> listheader</H3>    <tt>checkbox</tt>, set the <tt>label</tt> attribute. 
<P>Text header for listbox column    <h4><a name="77055"></a> See Also</h4>
<A NAME="77186"></A> Contained by    radio 
listhead <!--INDEX listheader element, XUL -->    <hr>
<H4><A NAME="77186"></A> Additional Attributes</H4>    <h3>colorpicker</h3>
<TT>sortActive</TT>, <TT>sortDirection</TT>, <TT>resource</TT>, <TT>sortable</TT>    <p>Widget used to choose a color Additional Attributes
<H4><A NAME="77186"></A> Description</H4>    <tt>onchange</tt>, <tt><!--INDEX colorpicker element, XUL -->
The <TT>listheader</TT> element displays the header text.    type</tt>, <tt>id</tt>, <tt>palettename</tt></p>
<H4><A NAME="77186"></A> See Also</H4>    <h4><a name="77059"></a> Description</h4>
<TT>listbox</TT>, <TT>listcell, listcol</TT>, <TT>listcols</TT>, <TT>listhead</TT>, <TT>listitem</TT>    When activated, this widget presents a choice of colors to the
<HR><H3><A NAME="77192"></A> listitem</H3>    user in a grid format. The user selects a color by clicking on
<P>Listbox row definition    it. The <tt>palettename</tt> attribute determines the displayed
<A NAME="77192"></A> Contained By    colors. Three values for this attribute represent three types
listbox <!--INDEX listitem element, XUL -->    of palettes: standard, grey, and web. 
<A NAME="77192"></A> Contains    <h4><a name="77059"></a> JavaScript Methods and Properties</h4>
listcell    color 
<H4><A NAME="77192"></A> Additional Attributes</H4>    <hr>
<TT>value</TT>, <TT>description</TT>, <TT>accesskey</TT>, <TT>label</TT>, <TT>context</TT>, <TT>type</TT>, <TT>name</TT>    <h3><a name="77064"></a> column</h3>
<H4><A NAME="77192"></A> Description</H4>    <p>A column in a grid <a name="77064"></a> Contained by columns
A <TT>listitem</TT> is a row in a <TT>listbox</TT>. The number of <TT>listcell</TT> children corresponds to the number of columns in the <TT>listbox</TT>.    <!--INDEX column element, XUL -->
<H4><A NAME="77192"></A> See Also</H4>    </p>
<TT>listbox</TT>, <TT>listcell</TT>, <TT>listcol</TT>, <TT>listcols</TT>, <TT>listhead</TT>, <TT>listheader</TT>    <h4><a name="77064"></a> Additional Attributes</h4>
<HR><H3><A NAME="77196"></A> member</H3>    None. 
<P>Matches container relationships  in which the parent element is given by  a container element and the child by a child element    <h4><a name="77064"></a> Description</h4>
Additional Attributes    <tt>column</tt> is a column entry in a <tt>grid</tt>, of which
<TT>container</TT>,  <!--INDEX member element, XUL --> <TT>child</TT>    there can be one or more contained in a <tt>columns</tt>
<H4><A NAME="77196"></A> Description</H4>    element. The content of cells in a column is determined by the
The <TT>member</TT> element is part of the conditional structure in a XUL template. It creates a rule by which parent-child relationships are matched and used as a basis for drawing content in the XUL.    children of each <tt>row</tt> element. 
<H4><A NAME="77196"></A> See Also</H4>    <h4><a name="77064"></a> See Also</h4>
<TT>conditions</TT>, <TT>rules</TT>, <TT>bindings</TT>, <TT>template</TT>    <tt>columns</tt>, <tt>grid</tt>, <tt>row</tt>, <tt>rows</tt> 
<HR><H3><A NAME="77200"></A> menu</H3>    <hr>
<P>A menu element for containing menu items    <h3><a name="77069"></a> columns</h3>
<H4><A NAME="77200"></A> Additional Attributes</H4>    <p>Container for the number of columns in a grid <a name=
<TT>label</TT>, <TT>accesskey</TT>,  <!--INDEX menu element, XUL --> <TT>disabled</TT>, <TT>image</TT>, <TT>disabled</TT>    "77069"></a> Contains column <!--INDEX columns element, XUL -->
<H4><A NAME="77200"></A> Description</H4>    </p>
<TT>menu</TT> is the basic menu widget. It's often contained in a <TT>menubar</TT>, but may appear elsewhere. The actual <TT>menuitems</TT> are defined within a <TT>menupopup</TT> that is usually the direct child of <TT>menu</TT>.    <h4><a name="77069"></a> Additional Attributes</h4>
<H4><A NAME="77200"></A> See Also</H4>    None. 
<TT>menubar</TT>, <TT>menubutton</TT>, <TT>menuitem</TT>, <TT>menulist</TT>, <TT>menupopup</TT>, <TT>menuseparator</TT>    <h4><a name="77069"></a> Description</h4>
<HR><H3><A NAME="77205"></A> menubar</H3>    The children of this element are one or more <tt>column</tt>
<P>Containing element for one or more menus    elements, the number of which determines the actual number of
<A NAME="77205"></A> Contains    grid columns. 
menu    <h4><a name="77069"></a> See Also</h4>
<H4><A NAME="77205"></A> Additional Attributes</H4>    <tt>column</tt>, <tt>grid</tt>, <tt>row</tt>, <tt>rows</tt> 
None.    <hr>
<H4><A NAME="77205"></A> Description</H4>    <h3>command</h3>
<TT>menubar</TT> is a special box for containing  <!--INDEX menubar element, XUL --> menus (though it can include other content). By default it has a <TT>grippy</TT> for expanding and collapsing the menubar.    <p>Defines functionality that can be called from multiple
<H4><A NAME="77205"></A> See Also</H4>    sources Contained by commandset 
<TT>menu</TT>, <TT>menubutton</TT>, <TT>menuitem</TT>, <TT>menulist</TT>, <TT>menupopup</TT>, <TT>menuseparator</TT>,<TT> grippy</TT>    <!--INDEX command element, XUL -->
<HR><H3><A NAME="77210"></A> menuitem</H3>    </p>
<P>Single selectable choice in a menu    <h4><a name="77074"></a> Additional Attributes</h4>
<A NAME="77210"></A> Contained by    <tt>disabled</tt>, <tt>accesskey</tt>, <tt>observes</tt>,
menupopup <!--INDEX menuitem element, XUL -->    <tt>label</tt>, <tt>checked</tt> 
<H4><A NAME="77210"></A> Additional Attributes</H4>    <h4><a name="77074"></a> Description</h4>
<TT>label</TT>, <TT>accesskey</TT>, <TT>crop</TT>, <TT>image</TT>, <TT>disabled</TT>, <TT>checked</TT>    The <tt>command</tt> element provides a place to organize
<H4><A NAME="77210"></A> Description</H4>    functionality used in more than one place in the interface-from
The <TT>menuitem</TT> is the basic element used to display a single item in a menu (e.g., <TT>&lt;menuitem</TT> <TT>label="File"/&gt;</TT>).    a context menu, a keyboard shortcut, and a regular menu, for
<H4><A NAME="77210"></A> See Also</H4>    example. The element is identified and shared by using its
menu, menubar, menubutton, menulist, menupopup, menuseparator    <tt>ID</tt> value and an interested element's (i.e., a menu
<HR><H3><A NAME="77215"></A> menulist</H3>    that wants the command) <tt>observes</tt> attribute. It also
<P>Drop-down list of selectable items    typically calls a JavaScript command from its
<A NAME="77215"></A> Contains    <tt>oncommand</tt> event handler. 
menupopup <!--INDEX menulist element, XUL -->    <h4><a name="77074"></a> See Also</h4>
<H4><A NAME="77215"></A> Additional Attributes</H4>    <tt>commands</tt>, <tt>commandset</tt> 
None.    <hr>
<H4><A NAME="77215"></A> Description</H4>    <h3><a name="77078"></a> commands</h3>
The <TT>menulist</TT> displays a list of menuitems, the selected one of which is displayed in the <TT>menulist</TT> itself. It is a type of drop-down menu.    <p>Container for a group of command sets</p>
<H4><A NAME="77215"></A> See Also</H4>    <h4><a name="77078"></a> Additional Attributes</h4>
<TT>menu</TT>, <TT>menubar</TT>, <TT>menubutton</TT>, <TT>menuitem</TT>, <TT>menupopup</TT>, <TT>menuseparator</TT>    None. <!--INDEX commands element, XUL -->
<HR><H3><A NAME="77221"></A> menupopup</H3>    <h4><a name="77078"></a> Description</h4>
<P>Pop-up container for menu items    <tt>commandsets</tt> no longer need to be contained within a
<A NAME="77221"></A> Contained By    <tt>commands</tt> element. Still, the <tt>commands</tt> group
<TT>menu</TT>, <TT> <!--INDEX menupopup element, XUL --> menubutton</TT>, <TT>menulist</TT>    can help you organize your code and user overlays to import
<A NAME="77221"></A> Contains    commands, especially related sets. 
menuitem    <h4><a name="77078"></a> See Also</h4>
<H4><A NAME="77221"></A> Additional Attributes</H4>    <tt>command</tt>, <tt>commandset</tt> 
<TT>popupalign</TT>, <TT>datasources</TT>, <TT>onpopupshowing</TT>, <TT>sortResource</TT>,<TT> onpopuphiding</TT>, <TT>sortDirection</TT>, <TT>context</TT>, <TT>position</TT>, <TT>popupanchor</TT>, <TT>ref</TT>    <hr>
<H4><A NAME="77221"></A> Description</H4>    <h3><a name="77083"></a> commandset</h3>
The <TT>menupopup</TT> contains the actual menu items defined for a menu and acts much like the <TT>popup</TT> element to show the window with a list of choices.    <p>A container for multiple command elements <a name=
<H4><A NAME="77221"></A> See Also</H4>    "77083"></a> Contains command</p>
popup, menu, menubar, menubutton, menuitem, menulist, menuseparator    <h4><a name="77083"></a> Additional Attributes</h4>
<HR><H3><A NAME="77226"></A> menuseparator</H3>    <tt>oncommandupdate</tt>, <!--INDEX commandset element, XUL -->
<P>Line separating menu items    <tt>commandupdater</tt>, <tt>events</tt> 
<A NAME="77226"></A> Contained By    <h4><a name="77083"></a> Description</h4>
menupopup <!--INDEX menuseparator element, XUL -->    An invisible, document-level element that acts as a logical
<H4><A NAME="77226"></A> Additional Attributes</H4>    grouping for commands or other command sets. 
type    <h4><a name="77083"></a> See Also</h4>
<H4><A NAME="77226"></A> Description</H4>    <tt>command</tt>, <tt>commands</tt> 
The <TT>menuseparator</TT> is a line through the menu that divides menu items into different groups. You can use the <TT>position</TT> attribute on the <TT>menuseparator</TT> to make sure it appears in a particular place, or you can use the common attribute <TT>insertAfter</TT>.    <hr>
<H4><A NAME="77226"></A> See Also</H4>    <h3><a name="77088"></a> conditions</h3>
<TT>menu</TT>, <TT>menubar</TT>, <TT>menubutton</TT>, <TT>menuitem</TT>, <TT>menulist</TT>, <TT>menuspopup</TT>    <p>Defines the conditions within a template rule <a name=
<HR><H3><A NAME="77230"></A> observes</H3>    "77088"></a> Contains <tt>content</tt>, <tt>member</tt>, triple
<P>Broadcast event and attribute listener    <!--INDEX conditions element, XUL -->
<H4><A NAME="77230"></A> Additional Attributes</H4>    </p>
<TT>element</TT>, <TT>attribute</TT>,  <!--INDEX observes element, XUL --> <TT>onbroadcast</TT>    <h4><a name="77088"></a> Additional Attributes</h4>
<H4><A NAME="77230"></A> Description</H4>    None. 
The <TT>observes</TT> element observes the state of a broadcasting element and its attributes. <TT>observes</TT> can be a separate element, defined as a child of the interested observer, or it can be an attribute on any element that wants to watch changes in a broadcasting element.    <h4><a name="77088"></a> Description</h4>
<H4><A NAME="77230"></A> See Also</H4>    Within a <tt>template</tt>, the <tt>conditions</tt>,
broadcaster    <tt>action</tt>, and sometimes the <tt>bindings</tt> elements
<HR><H3><A NAME="77234"></A> overlay</H3>    comprise a single rule. The children of the <tt>conditions</tt>
<P>Root element in a separate file that contains reusable XUL content    element must be matched to the processed data for that rule's
<H4><A NAME="77234"></A> Additional Attributes</H4>    action to make content. 
<TT>xmlns</TT>, title <!--INDEX overlay element, XUL -->    <h4><a name="77088"></a> See Also</h4>
<H4><A NAME="77234"></A> Description</H4>    <tt>template</tt>, <tt>rule</tt>, <tt>action</tt>,
Like <TT>page</TT>, <TT>window</TT>, <TT>dialog</TT>, and <TT>wizard</TT>, <TT>overlay</TT> is a XUL document's root element. Overlay documents contain content blocks that are overlaid dynamically at runtime into XUL content whose IDs match theirs. For example, a <TT>menupopup</TT> with the <TT>ID</TT> "file" and a <TT>menuitem</TT> child in an overlay adds that new <TT>menuitem</TT> into any <TT>menupopup</TT> with the <TT>ID</TT> "file" that it finds in the base XUL.    <tt>member</tt>, <tt>triple</tt>, <tt>content</tt> 
<H4><A NAME="77234"></A> See Also</H4>    <hr>
<TT>page</TT>, <TT>window</TT>    <h3><a name="77093"></a> content</h3>
<HR><H3><A NAME="77238"></A> page</H3>    <p>Binds variables in a template <a name="77093"></a> Contained
<P>Root element of XUL file loaded in a content frame    by conditions <!--INDEX conditions element, XUL -->
<H4><A NAME="77238"></A> Additional Attributes</H4>    </p>
<TT>context</TT>,  <!--INDEX page element, XUL --> <TT>headertitle</TT>, <TT>onload</TT>, <TT>onunload</TT>, <TT>title</TT>, <TT>xmlns</TT>    <h4><a name="77093"></a> Additional Attributes</h4>
<H4><A NAME="77238"></A> Description</H4>    None. 
<TT>page</TT> is the root element for a XUL document that is meant to be loaded within another XUL document, such as a preference panel.    <h4><a name="77093"></a> Description</h4>
<H4><A NAME="77238"></A> See Also</H4>    The <tt>content</tt> element is the portion of a template's
<TT>dialog</TT>, <TT>overlay</TT>, <TT>window</TT>    <tt>conditions</tt> element that associates a variable, often
<HR><H3><A NAME="77242"></A> popup</H3>    representing a URI (e.g., <tt>&lt;content uri="?uri"/&gt;</tt>)
<P>Box container as child window    with the data. 
<H4><A NAME="77242"></A> Additional Attributes</H4>    <h4><a name="77093"></a> See Also</h4>
<TT>onpopupshowing</TT>,  <!--INDEX popup element, XUL --> onpopuphiding    <tt>template</tt>, <tt>rule</tt>, <tt>action</tt>,
<H4><A NAME="77242"></A> Description</H4>    <tt>conditions</tt>, <tt>member</tt>, <tt>triple</tt> 
<TT>popup</TT> is a pop-up window that can be hooked up to any UI content. It is often used for context menus and invoked by elements that use its <TT>ID</TT> attribute in their <TT>popup</TT> or <TT>context</TT> attribute.    <hr>
<H4><A NAME="77242"></A> See Also</H4>    <h3>deck</h3>
<TT>menupopup</TT>, <TT>popupset</TT>    <p>Box container that displays one child element at a time
<HR><H3><A NAME="77246"></A> popupset</H3>    Additional Attributes selectedIndex</p>
<P>Container for popup elements    <h4><a name="77097"></a> Description</h4>
<H4><A NAME="77246"></A> Additional Attributes</H4>    <tt>deck</tt> uses the attribute <tt>selectedIndex</tt> 
None. <!--INDEX popupset element, XUL -->    <!--INDEX deck element, XUL --> to determine which child
<H4><A NAME="77246"></A> Description</H4>    element to display. The others are hidden until they are
While not strictly necessary as a container for the <TT>popup</TT> element, <TT>popupset</TT> helps you organize and overlays groups of popups.    displayed by index. <tt>deck</tt> is often used dynamically via
<H4><A NAME="77246"></A> See Also</H4>    the DOM to cycle through child elements, such as buttons. 
popup    <h4><a name="77097"></a> See Also</h4>
<HR><H3><A NAME="77249"></A> progressmeter</H3>    stack 
<P>Visual progress indicator of a time-consuming operation    <hr>
<H4><A NAME="77249"></A> Additional Attributes</H4>    <h3><a name="77101"></a> description</h3>
<TT>value</TT>,  <!--INDEX progressmeter element, XUL --> mode    <p>Holder for block of text that can wrap to multiple lines</p>
<H4><A NAME="77249"></A> Description</H4>    <h4><a name="77101"></a> Additional Attributes</h4>
This high-level widget uses its <TT>value</TT> attribute to fill in a meter that usually represents how long a particular task takes. You can change the <TT>value</TT> attribute dynamically to update the fill or set the mode to "undetermined" (as opposed to the default "determined" mode) to display a busy meter that doesn't chart actual progress.    <tt>crop</tt>, <tt>onmouseover</tt>, 
<HR><H3><A NAME="77253"></A> radio</H3>    <!--INDEX description element, XUL --> <tt>onmouseout</tt>,
<P>Single on/off choice represented as selectable circle    <tt>value</tt> 
<A NAME="77253"></A> Contained By    <h4><a name="77101"></a> Description</h4>
radiogroup <!--INDEX radio element, XUL -->    The <tt>description</tt> element replaces
<H4><A NAME="77253"></A> Additional Attributes</H4>    <tt>&lt;html:label&gt;</tt> and other HTML-namespaced elements
<TT>selected</TT>, <TT>group</TT>, <TT>label</TT>, <TT>accesskey</TT>, <TT>value</TT>    to wrap text in XUL interfaces. Text in a <tt>description</tt>
<H4><A NAME="77253"></A> Description</H4>    can be defined as content with the open and close tags or
Within a <TT>radiogroup</TT> element, a single <TT>radio</TT> widget is selected to indicate user choice. <TT>radio</TT> elements can also be used singularly to check an option on or off in the interface.    provided in the <tt>value</tt> attribute. Note that the text
<HR><H3><A NAME="77257"></A> radiogroup</H3>    does not wrap when placed in the <tt>value</tt> attribute. 
<P>Framed box for containing radio elements    <h4><a name="77101"></a> See Also</h4>
<A NAME="77257"></A> Contains    <tt>caption</tt>, <tt>label</tt> 
radio <!--INDEX radiogroup element, XUL -->    <hr>
<H4><A NAME="77257"></A> Additional Attributes</H4>    <h3><a name="77105"></a> dialog</h3>
disabled    <p>Root element for secondary XUL window</p>
<H4><A NAME="77257"></A> Description</H4>    <h4><a name="77105"></a> Additional Attributes</h4>
The <TT>radiogroup</TT> makes all <TT>radio</TT> elements within it belong to a single group from which only a single element can be selected.    <tt>ondialogaccept</tt>, <tt>ondialogcancel</tt>,
<HR><H3><A NAME="77261"></A> resizer</H3>    <tt>ondialoghelp</tt>, <tt>onunload</tt>, <tt>onload</tt>,
<P>Window-resizing element    <tt>title</tt>, <tt>buttons</tt>, <tt>windowtype</tt>,
<H4><A NAME="77261"></A> Additional Attributes</H4>    p<tt>ersist</tt>, <tt>y</tt>, <tt>x</tt>, <tt>screenY</tt>,
direction <!--INDEX resizer element, XUL -->    <tt>screenX</tt> 
<H4><A NAME="77261"></A> Description</H4>    <h4><a name="77105"></a> Description</h4>
A bar that changes the cursor when hovered over to signify that the bar can be dragged to resize the a window. The <TT>direction</TT> attribute specifies which way the window is resized, and can have values such as <TT>topleft</TT>, <TT>top</TT>, <TT>right</TT>, and <TT>bottomright</TT>. For example, a value of <TT>bottomleft</TT> resizes the window down and to the left.    <tt>dialog</tt> is a version of the <tt>window</tt> element 
<H4><A NAME="77261"></A> See Also</H4>    <!--INDEX dialog element, XUL --> built for displaying a
window    secondary dialog window in the application. Like
<HR><H3><A NAME="77266"></A> row</H3>    <tt>window</tt>, <tt>dialog</tt> is the root element in a XUL
<P>Container for grid cells laid out consecutively    file. Event handlers such as <tt>ondialogaccept</tt> and
<A NAME="77266"></A> Contained By    <tt>ondialogcancel</tt> are included as conveniences for
rows <!--INDEX row element, XUL -->    handling user input. 
<H4><A NAME="77266"></A> Additional Attributes</H4>    <h4><a name="77105"></a> See Also</h4>
None.    <tt>window</tt>, <tt>page</tt> 
<H4><A NAME="77266"></A> Description</H4>    <hr>
<TT>row</TT> is a single row in a <TT>grid</TT>. It is analogous to the <TT>&lt;TR&gt;</TT> element in HTML.    <h3><a name="77110"></a> dialogheader</h3>
<H4><A NAME="77266"></A> See Also</H4>    <p>Styled text heading for UI panel <a name="77110"></a>
<TT>grid</TT>, <TT>rows</TT>    Contained by dialog</p>
<HR><H3><A NAME="77271"></A> rows</H3>    <h4><a name="77110"></a> Additional Attributes</h4>
<P>Definition for grid rows    <tt>title</tt>, <!--INDEX dialogheader element, XUL -->
<A NAME="77271"></A> Contains    description 
row <!--INDEX rows element, XUL -->    <h4><a name="77110"></a> Description</h4>
<H4><A NAME="77271"></A> Additional Attributes</H4>    This is a formatted horizontal panel that contains text
None.    specified by the <tt>title</tt> attribute. This element is the
<H4><A NAME="77271"></A> Description</H4>    heading that appears at the top of the right panel in the
The <TT>rows</TT> element is a child of the <TT>grid</TT> element that contains any number of individual <TT>row</TT> elements. It is a sibling of <TT>columns</TT> within the <TT>grid</TT>.    Mozilla global preferences dialog. 
<H4><A NAME="77271"></A> See Also</H4>    <h4><a name="77110"></a> See Also</h4>
<TT>grid</TT>, <TT>row</TT>, <TT>columns</TT>, <TT>column</TT>    <tt>window</tt>, <tt>dialog</tt> 
<HR><H3><A NAME="77276"></A> rule</H3>    <hr>
<P>Defines rules for rendering data as XUL    <h3><a name="77115"></a> editor</h3>
<A NAME="77276"></A> Contained by    <p>Content area for editable web content</p>
template <!--INDEX rule element, XUL -->    <h4><a name="77115"></a> Additional Attributes</h4>
<H4><A NAME="77276"></A> Additional Attributes</H4>    src <!--INDEX editor element, XUL -->
<TT>rdf:type</TT>, <TT>parent</TT>, <TT>isempty</TT>, <TT>iscontainer</TT>    <h4><a name="77115"></a> Description</h4>
<H4><A NAME="77276"></A> Description</H4>    This high-level widget edits text and HTML.
The children of the <TT>rule</TT> element define a rule: the conditions stated in the <TT>conditions</TT> element must be met, the <TT>bindings</TT> provides optional matching, and the content in the <TT>action</TT> element is rendered if the rule is matched.    <tt>contentDocument</tt> is a reference to the document
<H4><A NAME="77276"></A> See Also</H4>    contained within the editor. 
<TT>template</TT>, <TT>action</TT>, <TT>conditions</TT>    <h4><a name="77115"></a> JavaScript Methods and Properties</h4>
<HR><H3><A NAME="77279"></A> script</H3>    contentDocument 
<P>Declaration of script used in XUL file    <h4><a name="77115"></a> See Also</h4>
<H4><A NAME="77279"></A> Additional Attributes</H4>    <tt>browser</tt>, <tt>iframe</tt> 
<TT>src</TT>, type <!--INDEX script element, XUL -->    <hr>
<H4><A NAME="77279"></A> Description</H4>    <h3><a name="77120"></a> grid</h3>
The <TT>script</TT> element can contain script content (e.g., <TT>&lt;script&gt;alert("it")&lt;/script&gt;</TT>) and can also import scripts in JavaScript files, in which case the <TT>src</TT> attribute is used. The type for JavaScript is <TT>application/x-javascript</TT>, and the <TT>src</TT> attribute may also use <I>chrome://</I> type URLs to point at JavaScript in the chrome.    <p>Widget for laying out content in a structured tabular
<HR><H3>scrollbar</H3>    fashion <a name="77120"></a> Contains <tt>rows</tt>,
<P>Widget for scrolling in a container    <tt>columns</tt></p>
Contains    <h4><a name="77120"></a> Additional Attributes</h4>
<TT>scrollbarbutton</TT>,  <!--INDEX scrollbar element, XUL --> <TT>slider</TT>    None. 
<H4><A NAME="77283"></A> Additional Attributes</H4>    <h4><a name="77120"></a> Description</h4>
<TT>curpos</TT>, <TT>increment</TT>, <TT>maxpos</TT>, <TT>pageincrement</TT>    The number of column elements <!--INDEX grid element, XUL -->
<H4><A NAME="77283"></A> Description</H4>    that are placed in rows determines the number of columns and
The <TT>scrollbar</TT> element uses the <TT>curpos</TT> and <TT>maxpos</TT> attributes to determine where the <TT>scrollbarbutton</TT> element is drawn within its length. <TT>increment</TT> specifies how much the scrollbar should move on user input. <TT>pageincrement</TT> specifies how many pages it should move.    the content for each row is placed in the <tt>row</tt> element.
<HR><H3><A NAME="77287"></A> scrollbarbutton</H3>    The number of row children must correspond to the number of
<P>Button used to move position of scrollbar thumb    columns. 
<A NAME="77287"></A> Contained By    <h4><a name="77120"></a> See Also</h4>
scrollbar <!--INDEX scrollbarbutton element, XUL -->    <tt>column</tt>, <tt>columns</tt>, <tt>listbox</tt>,
<H4><A NAME="77287"></A> Additional Attributes</H4>    <tt>row</tt>, <tt>rows</tt>, <tt>tree</tt> 
<TT>sborient</TT>, <TT>type</TT>    <hr>
<H4><A NAME="77287"></A> Description</H4>    <h3><a name="77124"></a> grippy</h3>
The <TT>scrollbarbutton</TT> can use its <TT>src</TT> attribute to point to an image that should be drawn over it.    <p>Visible widget used on a grippy bar to expand or collapse a
<HR><H3><A NAME="77291"></A> scrollbox</H3>    UI region <a name="77124"></a> Contained by splitter 
<P>Box for scrolling content    <!--INDEX grippy element, XUL -->
<H4><A NAME="77291"></A> Additional Attributes</H4>    </p>
crop <!--INDEX scrollbox element, XUL -->    <h4><a name="77124"></a> Additional Attributes</h4>
<H4><A NAME="77291"></A> Description</H4>    None. 
The <TT>scrollbox</TT> is a regular box with scrollbars that display automatically when the content inside the box overflows the size of the box itself.    <h4><a name="77124"></a> Description</h4>
<H4><A NAME="77291"></A> See Also</H4>    <tt>grippy</tt> appears as a child of a <tt>splitter</tt> and
<TT>box</TT>, <TT>hbox</TT>, <TT>vbox</TT>    provides the little "handle" that opens and closes the
<HR><H3><A NAME="77295"></A> separator</H3>    <tt>sidebar</tt> and other collapsible elements in the
<P>Bar between elements    interface. 
<H4><A NAME="77295"></A> Additional Attributes</H4>    <hr>
None.    <h3><a name="77129"></a> groupbox</h3>
<H4><A NAME="77295"></A> Description</H4>    <p>Box with frame surrounding it <a name="77129"></a> Contains
The <TT>separator</TT> is a  <!--INDEX separator element, XUL --> general-purpose divider. In menus, use <TT>menuseparator</TT>.    caption <!--INDEX groupbox element, XUL -->
<H4><A NAME="77295"></A> See Also</H4>    </p>
menuseparator    <h4><a name="77129"></a> Additional Attributes</h4>
<HR><H3><A NAME="77299"></A> slider</H3>    None. 
<P>A scrollbar without buttons    <h4><a name="77129"></a> Description</h4>
<H4><A NAME="77299"></A> Additional Attributes</H4>    The border that appears around and organizes elements in the
<TT>curpos</TT>, <TT>increment</TT>,  <!--INDEX slider element, XUL --> <TT>maxpos</TT>, <TT>pageincrement</TT>    interface (e.g., in dialogs where selectable elements are
<H4><A NAME="77299"></A> Description</H4>    grouped together); often comes from a <tt>groupbox</tt> parent.
The <TT>slider</TT> element provides simpler user input-a <TT>thumb</TT> button and no arrows-for scrolling large content. Like <TT>scrollbar</TT>, it uses <TT>curpos</TT> and <TT>maxpos</TT> to display its position.    
<H4><A NAME="77299"></A> See Also</H4>    <h4><a name="77129"></a> See Also</h4>
<TT>scrollbar</TT>, <TT>scrollbarbutton</TT>    box 
<HR><H3><A NAME="77302"></A> spacer</H3>    <hr>
<P>Blank space separating element    <h3><a name="77133"></a> hbox</h3>
<H4><A NAME="77302"></A> Additional Attributes</H4>    <p>Box container whose children are laid out horizontally</p>
None. <!--INDEX spacer element, XUL -->    <h4><a name="77133"></a> Additional Attributes</h4>
<H4><A NAME="77302"></A> Description</H4>    None. <!--INDEX hbox element, XUL -->
This element is a general-purpose blank space. The use of a <TT>spacer</TT> with <TT>flex</TT> to take up available space within a <TT>box</TT> and shrink its siblings is a staple of the box layout model that XUL uses.    <h4><a name="77133"></a> Description</h4>
<HR><H3><A NAME="77306"></A> splitter</H3>    The <tt>hbox</tt> element is a shorthand for <tt>&lt;box
<P>Element for dragging and resizing associated elements    orient="horizontal"&gt;</tt>. It is the preferred way to
<H4><A NAME="77306"></A> Additional Attributes</H4>    achieve horizontal orientation in box layout. 
<TT>persist</TT>,  <!--INDEX splitter element, XUL --> state    <h4><a name="77133"></a> See Also</h4>
<H4><A NAME="77306"></A> Description</H4>    <tt>box</tt>, <tt>vbox</tt> 
Users can drag a <TT>splitter</TT> to resize an associated element or panel that holds content and click a <TT>splitter</TT> to collapse the specified element within a box. To specify which element you manipulate with a <TT>splitter</TT>, set this element's <TT>collapse</TT> attribute accordingly: <TT>before</TT> to control the element before it in the parent; <TT>after</TT> to control the element after it.    <hr>
<H4><A NAME="77306"></A> See Also</H4>    <h3><a name="77137"></a> iframe</h3>
<TT>grippy</TT>, <TT>toolbar</TT>    <p>Web content area</p>
<HR><H3><A NAME="77309"></A> stack</H3>    <h4><a name="77137"></a> Additional Attributes</h4>
<P>Shows children one on top of one another, all at the same time    <tt>name</tt>, <tt>src</tt>, <tt>type</tt> 
<H4><A NAME="77309"></A> Description</H4>    <h4><a name="77137"></a> Description</h4>
In contrast to the <TT>deck</TT>, <TT>stack</TT> is a <TT>box</TT>  <!--INDEX stack element, XUL --> that displays all of its children at once. You can use a <TT>stack</TT> to display elements and blend them together, as when you use different stack children as background images and visual layers.    Like <tt>browser</tt>, <tt>iframe</tt> allows you to 
<H4><A NAME="77309"></A> See Also</H4>    <!--INDEX iframe element, XUL --> display web content, XML, and
<TT>deck</TT>, <TT>box</TT>    other data using the <tt>src</tt> attribute, but has less
<HR><H3><A NAME="77314"></A> statusbar</H3>    intrinsic browsing functionality available (such as browser
<P>Box container for status elements    history). You can use any number of iframes in a document. 
<A NAME="77314"></A> Contains    <h4><a name="77137"></a> See Also</h4>
statusbarpanel <!--INDEX statusbar element, XUL -->    <tt>browser</tt>, <tt>editor</tt> 
<H4><A NAME="77314"></A> Additional Attributes</H4>    <hr>
None.    <h3><a name="77140"></a> image</h3>
<H4><A NAME="77314"></A> Description</H4>    <p>Display of a supported type image</p>
In Mozilla, the <TT>statusbar</TT> is placed at the bottom of the main windows, where it is hooked up to the <TT>window.status</TT> property and can be used to display status text. It is divided into panels, one of which is the <TT>taskbar</TT> where some main component icons are displayed.    <h4><a name="77140"></a> Additional Attributes</h4>
<H4><A NAME="77314"></A> See Also</H4>    src 
statusbarpanel    <h4><a name="77140"></a> Description</h4>
<HR><H3><A NAME="77319"></A> statusbarpanel</H3>    The XUL image is analogous to the 
<P>Single unit of a statusbar    <!--INDEX image element, XUL --> HTML <tt>&lt;img&gt;</tt>
<A NAME="77319"></A> Contained by    element. The supported types in Gecko are PNG, JPG, GIF, and
statusbar <!--INDEX statusbarpanel element, XUL -->    BMP. 
<H4><A NAME="77319"></A> Additional Attributes</H4>    <hr>
<TT>persist</TT>, <TT>label</TT>    <h3><a name="77145"></a> key</h3>
<H4><A NAME="77319"></A> Description</H4>    <p>Definition for a keyboard shortcut <a name="77145"></a>
<TT>statusbarpanel</TT>s are subdivisions of the <TT>statusbar</TT> at the bottom of main browser windows. They can contain other content, text using the <TT>label</TT> attribute and an image using the <TT>list-style-image</TT> CSS style rule.    Contained by keyset <!--INDEX key element, XUL -->
<H4><A NAME="77319"></A> See Also</H4>    </p>
statusbar    <h4><a name="77145"></a> Additional Attributes</h4>
<HR><H3><A NAME="77324"></A> stringbundle</H3>    <tt>modifiers</tt>, <tt>command</tt>, <tt>key</tt> ,
<P>Holder of localized properties for use in script    <tt>keycode</tt>, <tt>observes</tt> 
<A NAME="77324"></A> Contained by    <h4><a name="77145"></a> Description</h4>
stringbundleset <!--INDEX stringbundle element, XUL -->    A <tt>key</tt> is often defined with a <tt>commandkey</tt> and
<H4><A NAME="77324"></A> Additional Attributes</H4>    a modifier (e.g., <tt>P</tt> + <tt>Ctrl</tt>), and uses an
src    <tt>oncommand</tt> event handler to fire the given command when
<H4><A NAME="77324"></A> Description</H4>    invoked. 
Like the <TT>script</TT> element, <TT>stringbundle</TT> uses the <TT>src</TT> attribute to locate a file for use. In this case, the files is a string bundle (properties file) that is used for holding localizable strings used in the UI.    <h4><a name="77145"></a> See Also</h4>
<H4><A NAME="77324"></A> See Also</H4>    keyset 
stringbundleset    <hr>
<HR><H3><A NAME="77329"></A> stringbundleset</H3>    <h3><a name="77150"></a> keybinding</h3>
<P>Container for stringbundle elements    <p>Container for a keyset or group of keysets <a name=
<A NAME="77329"></A> Contains    "77150"></a> Contains keyset 
stringbundle <!--INDEX stringbundleset element, XUL -->    <!--INDEX keybinding element, XUL -->
<H4><A NAME="77329"></A> Additional Attributes</H4>    </p>
None.    <h4><a name="77150"></a> Additional Attributes</h4>
<H4><A NAME="77329"></A> Description</H4>    None. 
<TT>stringbundleset</TT> is an optional container for groups of <TT>stringbundle</TT> elements. Like <TT>commandset</TT> use for commands, <TT>stringbundle</TT> organizes sets of related <TT>stringbundle</TT>s, particularly when those sets are overlaid into the UI.    <h4><a name="77150"></a> Description</h4>
<H4><A NAME="77329"></A> See Also</H4>    This element is used in an overlaid file to contain a group of
stringbundle    platform-specific key sets. It uses the <tt>ID</tt> attribute
<HR><H3><A NAME="77334"></A> tab</H3>    to overlay itself into XUL files that pick up sets of key
<P>A single selectable tab of a tabbox    bindings. 
<A NAME="77334"></A> Contained by    <h4><a name="77150"></a> See Also</h4>
tabs    <tt>key</tt>, <tt>keyset</tt> 
<H4><A NAME="77334"></A> Additional Attributes</H4>    <hr>
<TT>accesskey</TT>,  <!--INDEX tab element, XUL --> <TT>crop</TT>, <TT>disabled</TT>, <TT>label</TT>, <TT>image</TT>    <h3><a name="77154"></a> keyset</h3>
<H4><A NAME="77334"></A> Description</H4>    <p>Container for one or more key elements Contains key 
Individual tabs correspond to panels in the <TT>tabbox</TT>.    <!--INDEX keyset element, XUL -->
<H4><A NAME="77334"></A> See Also</H4>    </p>
<TT>tabbox</TT>, <TT>tabpanel</TT>, <TT>tabpanels</TT>, <TT>tabs</TT>    <h4><a name="77154"></a> Additional Attributes</h4>
<HR><H3>tabbox</H3>    None. 
<P>Box container for tab panels    <h4><a name="77154"></a> Description</h4>
Contains    <tt>key</tt> elements no longer need to be contained within a
<TT>tabs</TT>, tabpanels <!--INDEX tabbox element, XUL -->    <tt>keyset</tt> parent. Still, keysets can help organize groups
<H4><A NAME="77339"></A> Additional Attributes</H4>    of keys-particularly related ones. 
None.    <h4><a name="77154"></a> See Also</h4>
<H4><A NAME="77339"></A> Description</H4>    <tt>key</tt>, <tt>keybinding</tt> 
<TT>tabbox</TT> is the container in which the tabs and tabpanels are defined. It lays out children like a regular box to the orientation specified, which defaults to vertical. The panels are defined in the <TT>tabpanels</TT> element.    <hr>
<H4><A NAME="77339"></A> See Also</H4>    <h3><a name="77158"></a> label</h3>
<TT>tab</TT>, <TT>tabpanel</TT>, <TT>tabpanels</TT>, <TT>tabs</TT>    <p>Simple text display element and label for a control
<HR><H3><A NAME="77343"></A> tabbrowser</H3>    element</p>
<P>Tabbed holder for a set of web content views    <h4><a name="77158"></a> Additional Attributes</h4>
<H4><A NAME="77343"></A> Additional Attributes</H4>    <tt>control</tt>, <tt>for</tt>, <tt>accesskey</tt>,
<TT>contentcontextmenu</TT>,  <!--INDEX tabbrowser element, XUL --> <TT>contenttooltip</TT>    <tt>crop</tt>, <!--INDEX label element, XUL --> <tt>value</tt> 
<H4><A NAME="77343"></A> Description</H4>    <h4><a name="77158"></a> Description</h4>
<TT>tabbrowser</TT> derives from the <TT>browser</TT> widget. Like <TT>browser</TT>, it lets you view HTML pages and other content. <TT>tabbrowser</TT> has additional methods on it that manage tabbed windows (e.g., <TT>addTab</TT>, <TT>enterTabbedMode</TT>).    This text element can just display text in the UI. Unlike the
<H4><A NAME="77343"></A> See Also</H4>    <tt>description</tt> element, the text will not wrap. If you
browser    use it with a control element (the association occurs through
<HR><H3><A NAME="77349"></A> tabpanel</H3>    the <tt>for</tt> attribute, the value of which must match the
<P>A single panel of a tabbox    element's <tt>id</tt>) such as a <tt>textbox</tt>, the focus
<A NAME="77349"></A> Contained by    moves to the control element when the <tt>label</tt> is
tabpanels <!--INDEX tabpanel element, XUL -->    clicked. 
<A NAME="77349"></A> Contains    <h4><a name="77158"></a> See Also</h4>
XUL content    <tt>caption</tt>, <tt>description</tt> 
<H4><A NAME="77349"></A> Additional Attributes</H4>    <hr>
None.    <h3><a name="77162"></a> listbox</h3>
<H4><A NAME="77349"></A> Description</H4>    <p>Used for display of a flat list of items</p>
A <TT>tabpanel</TT> is one of the special <TT>box</TT> elements that correspond to a particular tab within a <TT>tabbox</TT>. It can hold any XUL content to be displayed on a particular tab panel.    <h4><a name="77162"></a> Additional Attributes</h4>
<H4><A NAME="77349"></A> See Also</H4>    <tt>datasources</tt>, <tt>sortResource</tt>, <tt>
<TT>tab</TT>, <TT>tabbox</TT>, <TT>tabpanels</TT>, <TT>tabs</TT>    <!--INDEX listbox element, XUL --> sortDirection</tt>,
<HR><H3><A NAME="77355"></A> tabpanels</H3>    <tt>rows</tt>, <tt>seltype</tt>, <tt>ref</tt> 
<P>Container for tabpanel elements    <h4><a name="77162"></a> Description</h4>
<A NAME="77355"></A> Contained by    <tt>listbox</tt> is a lightweight tabular display widget.
tabbox <!--INDEX tabpanels element, XUL -->    Unlike <tt>tree</tt>, it cannot handle nested rows. It does
<A NAME="77355"></A> Contains    support multiple columns, however. It is easy to use and
<TT>tabpanel</TT>, <TT>box</TT>    renders content very quickly. 
<H4><A NAME="77355"></A> Additional Attributes</H4>    <h4><a name="77162"></a> See Also</h4>
None.    <tt>listcell</tt>, <tt>listcol</tt>, <tt>listcols</tt>,
<H4><A NAME="77355"></A> Description</H4>    <tt>listhead</tt>, <tt>listheader</tt>, <tt>listitem</tt> 
The <TT>tabpanels</TT> container corresponds to the <TT>tabs</TT> element that holds all individual tabs, and is a container for the <TT>tabpanel</TT> associated with that tab. This child panel can be either an optional <TT>tabpanel</TT> element that holds XUL content, or just the XUL content.    <hr>
<H4><A NAME="77355"></A> See Also</H4>    <h3><a name="77167"></a> listcell</h3>
<TT>tab</TT>, <TT>tabbox</TT>, <TT>tabpanel</TT>, <TT>tabs</TT>    <p>Single cell of a listbox <a name="77167"></a> Contained by
<HR><H3><A NAME="77361"></A> tabs</H3>    listitem <!--INDEX listcell element, XUL -->
<P>Container for tab elements    </p>
<A NAME="77361"></A> Contained by    <h4><a name="77167"></a> Additional Attributes</h4>
tabbox <!--INDEX tabs element, XUL -->    <tt>label</tt>, <tt>flexlabel</tt>, <tt>crop</tt>,
<A NAME="77361"></A> Contains    <tt>disabled</tt>, <tt>image</tt>, <tt>checked</tt> 
tab    <h4><a name="77167"></a> Description</h4>
<H4><A NAME="77361"></A> Additional Attributes</H4>    The <tt>listcell</tt> is the element within a <tt>listbox</tt>
None.    that actually displays data. 
<H4><A NAME="77361"></A> Description</H4>    <h4><a name="77167"></a> See Also</h4>
This element is a required container for individual tabs.    <tt>listbox</tt>, <tt>listcol</tt>, <tt>listcols</tt>,
<H4><A NAME="77361"></A> See Also</H4>    <tt>listheader</tt>, <tt>listitem</tt> 
<TT>tab</TT>, <TT>tabbox</TT>, <TT>tabpanel</TT>, <TT>tabpanels</TT>    <hr>
<HR><H3><A NAME="77365"></A> template</H3>    <h3>listcol</h3>
<P>A high-level widget used to build content dynamically from data    <p>Listbox column definition <a name="77171"></a> Contained by
<A NAME="77365"></A> Contains    listcols <!--INDEX listcol element, XUL -->
rule <!--INDEX template element, XUL -->    </p>
<H4><A NAME="77365"></A> Additional Attributes</H4>    <h4><a name="77171"></a> Description</h4>
<TT>xmlns:nc</TT>, <TT>xmlns:chrome</TT>    This element represents a column in a <tt>listbox</tt>. 
<H4><A NAME="77365"></A> Description</H4>    <h4><a name="77171"></a> See Also</h4>
The <TT>template</TT> element has several <TT>rule</TT> children, each of which defines rules for matching data in a datasource and rendering that data as XUL content. A template is defined within the regular XUL content.    <tt>listbox</tt>, <tt>listcell</tt>, <tt>listcols</tt>,
<HR><H3><A NAME="77369"></A> textbox</H3>    <tt>listheader</tt>, <tt>listitem</tt> 
<P>Accepts text input from user    <hr>
<H4><A NAME="77369"></A> Additional Attributes</H4>    <h3><a name="77176"></a> listcols</h3>
<TT>multiline</TT>, <TT> <!--INDEX textbox element, XUL --> maxlength</TT>, <TT>disabled</TT>, <TT>readonly</TT>, <TT>type</TT>, <TT>size</TT>    <p>Container for listbox columns (listcol) <a name="77176"></a>
<H4><A NAME="77369"></A> Description</H4>    Contained by listbox <!--INDEX listcols element, XUL -->
<TT>textbox</TT> is a user-input element. Expand it beyond its single-line default by setting <TT>multiline</TT> to <TT>true</TT>. You can also disable it, and set its size.    <a name="77176"></a> Contains listcol</p>
<H4><A NAME="77369"></A> See Also</H4>    <h4><a name="77176"></a> Description</h4>
label    This element contains any number of individual <tt>listbox</tt>
<HR><H3><A NAME="77373"></A> thumb</H3>    columns. 
<P>Object used to move content in scrollable area    <h4><a name="77176"></a> See Also</h4>
<H4><A NAME="77373"></A> Additional Attributes</H4>    <tt>listbox</tt>, <tt>listcell</tt>, <tt>listcol</tt>,
sborient <!--INDEX thumb element, XUL -->    <tt>listheader</tt>, <tt>listitem</tt> 
<H4><A NAME="77373"></A> Description</H4>    <hr>
The <TT>thumb</TT> element appears in the <TT>slider</TT> and the <TT>scrollbar</TT>.    <h3><a name="77181"></a> listhead</h3>
<H4><A NAME="77373"></A> See Also</H4>    <p>Container for column header in list boxes (listheader) <a
<TT>scrollbar</TT>, <TT>scrollbarbutton</TT>, <TT>slider</TT>    name="77181"></a> Contained by listbox 
<HR><H3><A NAME="77378"></A> toolbar</H3>    <!--INDEX listhead element, XUL -->
<P>Holder of buttons for quick-access UI functionality    <a name="77181"></a> Contains listheader</p>
<A NAME="77378"></A> Contains    <h4><a name="77181"></a> Description</h4>
<TT>toolbarbutton</TT>,  <!--INDEX toolbar element, XUL --> <TT>toolbarseparator</TT>    The <tt>listhead</tt> element is analogous to the HTML
<H4><A NAME="77378"></A> Additional Attributes</H4>    <tt>thead</tt> element, and contains the header cells for an
<TT>grippyhidden</TT>, <TT>tborient</TT>, <TT>tbalign</TT>, <TT>tbpack</TT>    XUL listbox table. 
<H4><A NAME="77378"></A> Description</H4>    <h4><a name="77181"></a> See Also</h4>
Toolbars usually have horizontal orientation at the top of an application window, but this does not have to be the case. You can use the <TT>orient</TT> attribute to set it vertically and run its content down and not across. While the most common content for a toolbar is buttons and menus, it can contain any type of content.    <tt>listbox</tt>, <tt>listcell</tt>, <tt>listcol,
<H4><A NAME="77378"></A> See Also</H4>    listcols</tt>, <tt>listheader</tt>, <tt>listitem</tt> 
<TT>toolbarbutton</TT>, <TT>toolbarseparator</TT>, <TT>toolbox</TT>    <hr>
<HR><H3><A NAME="77383"></A> toolbarbutton</H3>    <h3><a name="77186"></a> listheader</h3>
<P>Specially adapted button for use in a toolbar    <p>Text header for listbox column <a name="77186"></a>
<A NAME="77383"></A> Contained by    Contained by listhead <!--INDEX listheader element, XUL -->
toolbar <!--INDEX toolbarbutton element, XUL -->    </p>
<H4><A NAME="77383"></A> Additional Attributes</H4>    <h4><a name="77186"></a> Additional Attributes</h4>
<TT>accesskey</TT>, <TT>dir</TT>, <TT>disabled</TT>, <TT>dlgType</TT>, <TT>group</TT>, <TT>image</TT>, <TT>label</TT>, <TT>orient</TT>, <TT>type</TT>, <TT>value</TT>    <tt>sortActive</tt>, <tt>sortDirection</tt>, <tt>resource</tt>,
<H4><A NAME="77383"></A> Description</H4>    <tt>sortable</tt> 
This is a button designed especially for a toolbar, with special stylings for this purpose. The current theme determines a <TT>toolbarbutton</TT>'s look. See <I>toolbar.css</I> in the theme JARs to view styles and bindings for this common button.    <h4><a name="77186"></a> Description</h4>
<H4><A NAME="77383"></A> See Also</H4>    The <tt>listheader</tt> element displays the header text. 
<TT>toolbar</TT>, <TT>toolbarseparator</TT>, <TT>toolbox</TT>    <h4><a name="77186"></a> See Also</h4>
<HR><H3><A NAME="77388"></A> toolbarseparator</H3>    <tt>listbox</tt>, <tt>listcell, listcol</tt>,
<P>Visible separator for elements contained in a toolbar    <tt>listcols</tt>, <tt>listhead</tt>, <tt>listitem</tt> 
<A NAME="77388"></A> Contained by    <hr>
toolbar <!--INDEX toolbarseparator element, XUL -->    <h3><a name="77192"></a> listitem</h3>
<H4><A NAME="77388"></A> Additional Attributes</H4>    <p>Listbox row definition <a name="77192"></a> Contained By
None.    listbox <!--INDEX listitem element, XUL -->
<H4><A NAME="77388"></A> Description</H4>    <a name="77192"></a> Contains listcell</p>
Like the <TT>menuseparator</TT> in a <TT>menu</TT>, <TT>toolbarseparator</TT> divides elements in a <TT>toolbar</TT>.    <h4><a name="77192"></a> Additional Attributes</h4>
<H4><A NAME="77388"></A> See Also</H4>    <tt>value</tt>, <tt>description</tt>, <tt>accesskey</tt>,
<TT>toolbar</TT>, <TT>toolbarbutton</TT>, <TT>toolbox</TT>    <tt>label</tt>, <tt>context</tt>, <tt>type</tt>, <tt>name</tt> 
<HR><H3><A NAME="77393"></A> toolbox</H3>    <h4><a name="77192"></a> Description</h4>
<P>Optional container for menu bars and toolbars    A <tt>listitem</tt> is a row in a <tt>listbox</tt>. The number
<A NAME="77393"></A> Contains    of <tt>listcell</tt> children corresponds to the number of
<TT>menubar</TT>,  <!--INDEX toolbox element, XUL --> <TT>toolbar</TT>    columns in the <tt>listbox</tt>. 
<H4><A NAME="77393"></A> Additional Attributes</H4>    <h4><a name="77192"></a> See Also</h4>
None.    <tt>listbox</tt>, <tt>listcell</tt>, <tt>listcol</tt>,
<H4><A NAME="77393"></A> Description</H4>    <tt>listcols</tt>, <tt>listhead</tt>, <tt>listheader</tt> 
<TT>toolbox</TT> can organize several toolbars into one parent element. <TT>toolbox</TT> inherits from <TT>box</TT>, so you can use box layout attributes to control the positioning and layout of toolbars within.    <hr>
<H4><A NAME="77393"></A> See Also</H4>    <h3><a name="77196"></a> member</h3>
<TT>menubar</TT>, <TT>toolbar</TT>    <p>Matches container relationships in which the parent element
<HR><H3><A NAME="77396"></A> tooltip</H3>    is given by a container element and the child by a child
<P>Pop-up window for context-sensitive help    element Additional Attributes <tt>container</tt>, 
<H4><A NAME="77396"></A> Additional Attributes</H4>    <!--INDEX member element, XUL --> <tt>child</tt></p>
<TT>noautohide</TT>,  <!--INDEX tooltip element, XUL --> <TT>onpopupshowing</TT>, <TT>onpopuphiding</TT>, <TT>position</TT>    <h4><a name="77196"></a> Description</h4>
<H4><A NAME="77396"></A> Description</H4>    The <tt>member</tt> element is part of the conditional
The <TT>tooltip</TT> element defines text to be displayed. It is associated by <TT>ID</TT> with elements that want to use its content in the pop ups they display. However, elements can also use the <TT>tooltip</TT> attribute to display a tooltip more directly for themselves.    structure in a XUL template. It creates a rule by which
<HR><H3><A NAME="77401"></A> tree</H3>    parent-child relationships are matched and used as a basis for
<P>Hierarchical holder of information represented as rows    drawing content in the XUL. 
<A NAME="77401"></A> Contains    <h4><a name="77196"></a> See Also</h4>
<TT>treecols</TT>, <TT>treechildren</TT>    <tt>conditions</tt>, <tt>rules</tt>, <tt>bindings</tt>,
<H4><A NAME="77401"></A> Additional Attributes</H4>    <tt>template</tt> 
<TT>multiple</TT>,  <!--INDEX tree element, XUL --> <TT>datasources</TT>, <TT>enableColumnDrag</TT>, <TT>containment</TT>,<TT> sortResource</TT>, <TT>sortDirection</TT>, <TT>border</TT>, <TT>seltype</TT>, <TT>sortActive</TT>, <TT>flags, context</TT>, <TT>persist</TT>, <TT>hidecolumnpicker</TT>    <hr>
<H4><A NAME="77401"></A> Description</H4>    <h3><a name="77200"></a> menu</h3>
The <TT>tree</TT> element is a high-level widget that displays tabular data. More complex than <TT>listbox</TT>, <TT>tree</TT> allows you to define nested content, different views, and data display, and provides methods that sort and manipulate its contents.    <p>A menu element for containing menu items</p>
<H4><A NAME="77401"></A> See Also</H4>    <h4><a name="77200"></a> Additional Attributes</h4>
<TT>treecell</TT>, <TT>treechildren</TT>, <TT>treecol</TT>, <TT>treecols</TT>, <TT>treeitem</TT>, <TT>treerow</TT>    <tt>label</tt>, <tt>accesskey</tt>, 
<HR><H3><A NAME="77406"></A> treecell</H3>    <!--INDEX menu element, XUL --> <tt>disabled</tt>,
<P>A single cell in a tree    <tt>image</tt>, <tt>disabled</tt> 
<A NAME="77406"></A> Contained by    <h4><a name="77200"></a> Description</h4>
treerow    <tt>menu</tt> is the basic menu widget. It's often contained in
<H4><A NAME="77406"></A> Additional Attributes</H4>    a <tt>menubar</tt>, but may appear elsewhere. The actual
<TT>src</TT>, <TT>indent</TT>,  <!--INDEX treecell element, XUL --> <TT>observes</TT>, <TT>url</TT>, <TT>value</TT>, <TT>label</TT>, <TT>sortActive, sortDirection</TT>, <TT>tag</TT>, <TT>mode</TT>, <TT>resource</TT>, <TT>allowevents</TT>, <TT>properties</TT>    <tt>menuitems</tt> are defined within a <tt>menupopup</tt> that
<H4><A NAME="77406"></A> Description</H4>    is usually the direct child of <tt>menu</tt>. 
The <TT>treecell</TT> contains the actual content to be displayed in a tree. That content can be in the form of a value for the <TT>label</TT> attribute. It can also be content in the <TT>treecell</TT>'s start and end tags (e.g., <TT>&lt;treecell&gt;data&lt;/treecell&gt;</TT>).    <h4><a name="77200"></a> See Also</h4>
<H4><A NAME="77406"></A> See Also</H4>    <tt>menubar</tt>, <tt>menubutton</tt>, <tt>menuitem</tt>,
tree, treechildren, treecol, treecols, treeitem, treerow    <tt>menulist</tt>, <tt>menupopup</tt>, <tt>menuseparator</tt> 
<HR><H3><A NAME="77412"></A> treechildren</H3>    <hr>
<P>The main body of a tree; a container for treeitems    <h3><a name="77205"></a> menubar</h3>
<A NAME="77412"></A> Contains    <p>Containing element for one or more menus <a name=
treeitem <!--INDEX treechildren element, XUL -->    "77205"></a> Contains menu</p>
<A NAME="77412"></A> Contained by    <h4><a name="77205"></a> Additional Attributes</h4>
tree    None. 
<H4><A NAME="77412"></A> Additional Attributes</H4>    <h4><a name="77205"></a> Description</h4>
open    <tt>menubar</tt> is a special box for containing 
<H4><A NAME="77412"></A> Description</H4>    <!--INDEX menubar element, XUL --> menus (though it can include
The <TT>treechildren</TT> element defines the subset of the <TT>tree</TT> where the content is actually contained (in contrast to <TT>treecols</TT>, which defines aspects of the layout).    other content). By default it has a <tt>grippy</tt> for
<H4><A NAME="77412"></A> See Also</H4>    expanding and collapsing the menubar. 
<TT>tree</TT>, <TT>treecell</TT>, <TT>treecol</TT>, <TT>treecols</TT>, <TT>treeitem</TT>, <TT>treerow</TT>    <h4><a name="77205"></a> See Also</h4>
<HR><H3><A NAME="77417"></A> treecol</H3>    <tt>menu</tt>, <tt>menubutton</tt>, <tt>menuitem</tt>,
<P>A single column of a tree    <tt>menulist</tt>, <tt>menupopup</tt>, <tt>menuseparator</tt>,
<A NAME="77417"></A> Contained by    <tt>grippy</tt> 
treecols <!--INDEX treecol element, XUL -->    <hr>
<H4><A NAME="77417"></A> Additional Attributes</H4>    <h3><a name="77210"></a> menuitem</h3>
<TT>sort</TT>, <TT>resource</TT>, <TT>primary</TT>, <TT>sortSeparators</TT>, <TT>label</TT>, <TT>sortActive</TT>,<TT> sortDirection</TT>, <TT>hideheader</TT>, <TT>accesskey</TT>, <TT>type</TT>    <p>Single selectable choice in a menu <a name="77210"></a>
<H4><A NAME="77417"></A> Description</H4>    Contained by menupopup <!--INDEX menuitem element, XUL -->
The <TT>treecol</TT> typically does not contain content. Instead, it defines the header for the columns whose contents are defined in the <TT>treerow</TT>s.    </p>
<H4><A NAME="77417"></A> See Also</H4>    <h4><a name="77210"></a> Additional Attributes</h4>
<TT>tree</TT>, <TT>treecell</TT>, <TT>treechildren</TT>, <TT>treecols</TT>, <TT>treeitem</TT>, <TT>treerow</TT>    <tt>label</tt>, <tt>accesskey</tt>, <tt>crop</tt>,
<HR><H3><A NAME="77423"></A> treecols</H3>    <tt>image</tt>, <tt>disabled</tt>, <tt>checked</tt> 
<P>Container for tree columns    <h4><a name="77210"></a> Description</h4>
<A NAME="77423"></A> Contained by    The <tt>menuitem</tt> is the basic element used to display a
tree    single item in a menu (e.g., <tt>&lt;menuitem</tt>
<A NAME="77423"></A> Contains    <tt>label="File"/&gt;</tt>). 
treecol    <h4><a name="77210"></a> See Also</h4>
<H4><A NAME="77423"></A> Additional Attributes</H4>    menu, menubar, menubutton, menulist, menupopup, menuseparator 
None.    <hr>
<H4><A NAME="77423"></A> Description</H4>    <h3><a name="77215"></a> menulist</h3>
This element is a container for a group of <TT>treecol</TT> elements, or columns, in a tree. A tree should have only one <TT>treecols</TT>.    <p>Drop-down list of selectable items <a name="77215"></a>
<H4><A NAME="77423"></A> See Also</H4>    Contains menupopup <!--INDEX menulist element, XUL -->
<TT>tree</TT>, <TT>treecell</TT>, <TT>treechildren</TT>, <TT>treecol</TT>, <TT>treeitem</TT>, <TT>treerow</TT>    </p>
<HR><H3><A NAME="77429"></A> treeitem</H3>    <h4><a name="77215"></a> Additional Attributes</h4>
<P>A treerow container    None. 
<A NAME="77429"></A> Contained by    <h4><a name="77215"></a> Description</h4>
treechildren <!--INDEX treeitem element, XUL -->    The <tt>menulist</tt> displays a list of menuitems, the
<A NAME="77429"></A> Contains    selected one of which is displayed in the <tt>menulist</tt>
treerow    itself. It is a type of drop-down menu. 
<H4><A NAME="77429"></A> Additional Attributes</H4>    <h4><a name="77215"></a> See Also</h4>
<TT>rdf:type</TT>, <TT>container</TT>, <TT>open</TT>    <tt>menu</tt>, <tt>menubar</tt>, <tt>menubutton</tt>,
<H4><A NAME="77429"></A> Description</H4>    <tt>menuitem</tt>, <tt>menupopup</tt>, <tt>menuseparator</tt> 
The <TT>treeitem</TT> element is a container for a <TT>treerow</TT>, and makes <TT>treerow</TT> a selectable element within the <TT>tree</TT>.    <hr>
<H4><A NAME="77429"></A> See Also</H4>    <h3><a name="77221"></a> menupopup</h3>
<TT>tree</TT>, <TT>treecell</TT>, <TT>treechildren</TT>, <TT>treecol</TT>, <TT>treecols</TT>, <TT>treerow</TT>    <p>Pop-up container for menu items <a name="77221"></a>
<HR><H3><A NAME="77435"></A> treerow</H3>    Contained By <tt>menu</tt>, <tt>
<P>A single row of a tree    <!--INDEX menupopup element, XUL --> menubutton</tt>,
<A NAME="77435"></A> Contained by    <tt>menulist</tt> <a name="77221"></a> Contains menuitem</p>
treeitem <!--INDEX treerow element, XUL -->    <h4><a name="77221"></a> Additional Attributes</h4>
<A NAME="77435"></A> Contains    <tt>popupalign</tt>, <tt>datasources</tt>,
treecell    <tt>onpopupshowing</tt>, <tt>sortResource</tt>,
<H4><A NAME="77435"></A> Additional Attributes</H4>    <tt>onpopuphiding</tt>, <tt>sortDirection</tt>,
properties    <tt>context</tt>, <tt>position</tt>, <tt>popupanchor</tt>,
<H4><A NAME="77435"></A> Description</H4>    <tt>ref</tt> 
Contained within a <TT>treeitem</TT>, this element represents a single row of a tree.    <h4><a name="77221"></a> Description</h4>
<H4><A NAME="77435"></A> See Also</H4>    The <tt>menupopup</tt> contains the actual menu items defined
<TT>tree</TT>, <TT>treecell</TT>, <TT>treechildren</TT>, <TT>treecol</TT>, <TT>treecols</TT>, <TT>treeitem</TT>    for a menu and acts much like the <tt>popup</tt> element to
<HR><H3><A NAME="77439"></A> triple</H3>    show the window with a list of choices. 
<P>Substructure of a template that matches RDF statements in the data    <h4><a name="77221"></a> See Also</h4>
<H4><A NAME="77439"></A> Additional Attributes</H4>    popup, menu, menubar, menubutton, menuitem, menulist,
<TT>predicate</TT>,  <!--INDEX triple element, XUL --> <TT>object</TT>, <TT>subject</TT>    menuseparator 
<H4><A NAME="77439"></A> Description</H4>    <hr>
The children of <TT>triple-predicate</TT>, <TT>object</TT>, and <TT>subject-</TT>match RDF statements that appear in the data processed in the template.    <h3><a name="77226"></a> menuseparator</h3>
<H4><A NAME="77439"></A> See Also</H4>    <p>Line separating menu items <a name="77226"></a> Contained By
<TT>template</TT>, <TT>member</TT>, <TT>content</TT>, <TT>conditions</TT>    menupopup <!--INDEX menuseparator element, XUL -->
<HR><H3><A NAME="77442"></A> vbox</H3>    </p>
<P>Box container with vertically laid out children    <h4><a name="77226"></a> Additional Attributes</h4>
<H4><A NAME="77442"></A> Additional Attributes</H4>    type 
None.    <h4><a name="77226"></a> Description</h4>
<H4><A NAME="77442"></A> See Also</H4>    The <tt>menuseparator</tt> is a line through the menu that
<TT>box</TT>,  <!--INDEX vbox element, XUL --> hbox    divides menu items into different groups. You can use the
<HR><H3><A NAME="77446"></A> window</H3>    <tt>position</tt> attribute on the <tt>menuseparator</tt> to
<P>Root element of a top-level XUL window document    make sure it appears in a particular place, or you can use the
<H4><A NAME="77446"></A> Additional Attributes</H4>    common attribute <tt>insertAfter</tt>. 
<TT>windowtype</TT>, <TT> <!--INDEX window element, XUL --> xmlns:rdf</TT>, <TT>xmlns:web</TT>, <TT>titlepreface</TT>, <TT>onload</TT>, <TT>onunload</TT>,<TT> xmlns</TT>, <TT>titlemodifier</TT>, <TT>xmlns:html</TT>, <TT>title</TT>, <TT>onclose</TT>,<TT> titlemenuseparator</TT>, <TT>contenttitlesetting</TT>, <TT>y</TT>, <TT>x</TT>, <TT>screenY</TT>, <TT>screenX</TT>    <h4><a name="77226"></a> See Also</h4>
<H4><A NAME="77446"></A> Description</H4>    <tt>menu</tt>, <tt>menubar</tt>, <tt>menubutton</tt>,
The <TT>window</TT> is an XUL document's basic root element. The contents of a XUL document, including the <TT>script</TT> elements, commands, keys, and broadcasters, appear as children of the window. Overlays, the XML and stylesheet-processing instructions, and the <TT>DOCTYPE</TT> declaration appear before and outside a document's root element. The window should have a unique ID and use minimally, the XUL namespace to identify markup elements as XUL: <TT>xmlns="<A HREF="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</A>"</TT>.    <tt>menuitem</tt>, <tt>menulist</tt>, <tt>menuspopup</tt> 
<H4><A NAME="77446"></A> See Also</H4>    <hr>
<TT>overlay</TT>, <TT>page</TT>    <h3><a name="77230"></a> observes</h3>
<HR><H3><A NAME="77451"></A> wizard</H3>    <p>Broadcast event and attribute listener</p>
<P>Window used to step though a task    <h4><a name="77230"></a> Additional Attributes</h4>
<A NAME="77451"></A> Contains    <tt>element</tt>, <tt>attribute</tt>, 
wizardpage    <!--INDEX observes element, XUL --> <tt>onbroadcast</tt> 
<H4><A NAME="77451"></A> Additional Attributes</H4>    <h4><a name="77230"></a> Description</h4>
<TT>onwizardaccept</TT>, <TT>onwizardcancel</TT>, <TT>xmlns</TT>, <TT>onwizardfinish</TT>,<TT> xmlns:nc</TT>    The <tt>observes</tt> element observes the state of a
<H4><A NAME="77451"></A> Description</H4>    broadcasting element and its attributes. <tt>observes</tt> can
Like <TT>dialog</TT>, <TT>wizard</TT> is a specialized version of the <TT>window</TT> root element. It easily creates multistep dialog windows that help users set up accounts, password data, and other customizable information. A <TT>wizard</TT> contains one or more <TT>wizardpage</TT>s.    be a separate element, defined as a child of the interested
<H4><A NAME="77451"></A> See Also</H4>    observer, or it can be an attribute on any element that wants
<TT>wizardpage</TT>, <TT>window</TT>, <TT>dialog</TT>    to watch changes in a broadcasting element. 
<HR><H3><A NAME="77456"></A> wizardpage</H3>    <h4><a name="77230"></a> See Also</h4>
<P>A single panel (step) of a wizard    broadcaster 
<A NAME="77456"></A> Contained by    <hr>
wizard    <h3><a name="77234"></a> overlay</h3>
<H4><A NAME="77456"></A> Additional Attributes</H4>    <p>Root element in a separate file that contains reusable XUL
<TT>label</TT>, <TT>pageid</TT>, <TT>onpageadvanced</TT>, <TT>onpageshow</TT>, <TT>onpagecancel</TT>    content</p>
<H4><A NAME="77456"></A> Description</H4>    <h4><a name="77234"></a> Additional Attributes</h4>
The <TT>wizardpage</TT> can contain  <!--INDEX wizardpage element, XUL --> arbitrary XUL content. One or more wizardpages are defined in a <TT>wizard</TT> window. The intrinsic functionality of a wizard window allows you to step through <TT>wizardpage</TT>s by setting the <TT>onpageshow</TT> and <TT>onpagecancel</TT> event handlers on individual pages and using the <TT>onwizardaccept</TT> and <TT>onwizardcancel</TT> event handlers on  <!--INDEX ENDRANGE--XUL element set --> the  <!--INDEX ENDRANGE--elements:XUL element set --> <TT>wizard</TT> parent element.    <tt>xmlns</tt>, title <!--INDEX overlay element, XUL -->
<H4><A NAME="77456"></A> See Also</H4>    <h4><a name="77234"></a> Description</h4>
<TT>wizard</TT>, <TT>window</TT>, <TT>dialog</TT>    Like <tt>page</tt>, <tt>window</tt>, <tt>dialog</tt>, and
    <tt>wizard</tt>, <tt>overlay</tt> is a XUL document's root
<H2><A NAME="77457"></A> XBL Element Set</H2>    element. Overlay documents contain content blocks that are
<P>The XBL 1.0 specification published on the <!--INDEX STARTRANGE--XBL element set;elements:XBL element set -->  mozilla.org web site appeared to be a beacon for application developers. Because the specification was available early in the development process, XBL seemed to be a tighter, more comprehensible language that was easier to learn and master than XUL. Since then, XBL development has strayed from the specification quite a bit, however, and now people consider XBL as opaque as XUL without good documentation that helps people learn and to create a roadmap for use based on continuing development.    overlaid dynamically at runtime into XUL content whose IDs
<P>This reference section tries to capture basic elements and attributes in XBL. Because it binds rather than creates content, XBL is smaller and     match theirs. For example, a <tt>menupopup</tt> with the
inherently more formal than XUL. Nonetheless, as you will see, the language has quite a bit of range and complexity. Each entry in this section describes the XBL element and its purpose, its position in the hierarchy (i.e., which elements it contains and which elements it is contained by), and lists the element's attributes. <A HREF="ch07.html#77027">Chapter 7</A> introduces XBL and shows how to use it. However, once you are familiar with the basics of XBL, you can consult this reference to find the XBL items you want.    <tt>ID</tt> "file" and a <tt>menuitem</tt> child in an overlay
<HR><H3><A NAME="77463"></A> binding</H3>    adds that new <tt>menuitem</tt> into any <tt>menupopup</tt>
<P>A single XBL binding    with the <tt>ID</tt> "file" that it finds in the base XUL. 
<A NAME="77463"></A> Contains    <h4><a name="77234"></a> See Also</h4>
<TT>content</TT>, <TT>implementation</TT>,  <!--INDEX binding element, XBL --> handlers    <tt>page</tt>, <tt>window</tt> 
<A NAME="77463"></A> Contained by    <hr>
bindings    <h3><a name="77238"></a> page</h3>
<A NAME="77463"></A> Attributes    <p>Root element of XUL file loaded in a content frame</p>
<TT>id</TT>, <TT>extends</TT>, <TT>display</TT>, <TT>applyauthorstyles</TT>, <TT>styleexplicitcontent</TT>    <h4><a name="77238"></a> Additional Attributes</h4>
<H4><A NAME="77463"></A> Description</H4>    <tt>context</tt>, <!--INDEX page element, XUL -->
This element defines a single XBL binding that can be attached to a bound document. It enables the creation of self-contained widgets that can contain content, implementation, and handlers. This element must have an <TT>id</TT> attribute value; this value is how it is associated-either through a CSS style rule or a DOM method-to the bound element that acts a placeholder for the binding that is filled out during attachment. The <TT>extends</TT> attribute inherits from a XUL element or another binding.    <tt>headertitle</tt>, <tt>onload</tt>, <tt>onunload</tt>,
<H4><A NAME="77463"></A> See Also</H4>    <tt>title</tt>, <tt>xmlns</tt> 
bindings    <h4><a name="77238"></a> Description</h4>
<HR><H3><A NAME="77468"></A> bindings</H3>    <tt>page</tt> is the root element for a XUL document that is
<P>An XBL document's root element    meant to be loaded within another XUL document, such as a
<A NAME="77468"></A> Contains    preference panel. 
<TT>binding</TT>, <TT>resources</TT>,  <!--INDEX bindings element, XBL --> stylesheet    <h4><a name="77238"></a> See Also</h4>
<A NAME="77468"></A> Attributes    <tt>dialog</tt>, <tt>overlay</tt>, <tt>window</tt> 
<TT>id</TT>, <TT>type</TT>    <hr>
<H4><A NAME="77468"></A> Description</H4>    <h3><a name="77242"></a> popup</h3>
This root container can hold one or more bindings, represented by the <TT>&lt;binding&gt;</TT> markup. The Mozilla code base references an XBL document through its name, which has an <I>.xml</I> extension. The document <TT>id</TT> has to be unique. The other children of <TT>&lt;bindings&gt;</TT> are <TT>&lt;resources&gt;</TT> and <TT>&lt;stylesheet&gt;</TT>, which contain style and image information to be used by the document's bindings.    <p>Box container as child window</p>
<H4><A NAME="77468"></A> See Also</H4>    <h4><a name="77242"></a> Additional Attributes</h4>
binding    <tt>onpopupshowing</tt>, <!--INDEX popup element, XUL -->
<HR><H3><A NAME="77473"></A> body</H3>    onpopuphiding 
<P>Container for JavaScript code to be executed by an XBL method    <h4><a name="77242"></a> Description</h4>
<A NAME="77473"></A> Contained by    <tt>popup</tt> is a pop-up window that can be hooked up to any
method <!--INDEX body element, XBL -->    UI content. It is often used for context menus and invoked by
<A NAME="77473"></A> Attributes    elements that use its <tt>ID</tt> attribute in their
id    <tt>popup</tt> or <tt>context</tt> attribute. 
<H4><A NAME="77473"></A> Description</H4>    <h4><a name="77242"></a> See Also</h4>
This element is designed as a holder for the method's script. It defines a logical block and differentiates the script from the parameter element, which also lies within the method. Script contained in a method has to be in a body element, which in turn should contain a CDATA section. &lt;![CDATA[...]]&gt; escapes JavaScript characters like quotes and slashes that may otherwise conflict with the XML parser.    <tt>menupopup</tt>, <tt>popupset</tt> 
<H4><A NAME="77473"></A> See Also</H4>    <hr>
method    <h3><a name="77246"></a> popupset</h3>
<HR><H3><A NAME="77477"></A> children</H3>    <p>Container for popup elements</p>
<P>Insertion point for children of a bound element, or inherited binding    <h4><a name="77246"></a> Additional Attributes</h4>
<A NAME="77477"></A> Contained by    None. <!--INDEX popupset element, XUL -->
content <!--INDEX children element, XBL -->    <h4><a name="77246"></a> Description</h4>
<A NAME="77477"></A> Attributes    While not strictly necessary as a container for the
<TT>id</TT>, <TT>includes</TT>, <TT>type</TT>    <tt>popup</tt> element, <tt>popupset</tt> helps you organize
<H4><A NAME="77477"></A> Description</H4>    and overlays groups of popups. 
This element needs to be placed in the binding content at the point where you want to place children of the bound element when the binding is rendered. If the children tag contains its own elements, then that element will be default content. If the element the binding attaches to contains children, the default content is ignored.    <h4><a name="77246"></a> See Also</h4>
<HR><H3><A NAME="77482"></A> constructor</H3>    popup 
<P>Container for code to be executed when a binding is created    <hr>
<A NAME="77482"></A> Contained by    <h3><a name="77249"></a> progressmeter</h3>
implementation <!--INDEX constructor element, XBL -->    <p>Visual progress indicator of a time-consuming operation</p>
<A NAME="77482"></A> Attributes    <h4><a name="77249"></a> Additional Attributes</h4>
<TT>action</TT>, <TT>class</TT>, <TT>id</TT>    <tt>value</tt>, <!--INDEX progressmeter element, XUL --> mode 
<H4><A NAME="77482"></A> Description</H4>    <h4><a name="77249"></a> Description</h4>
This behavior element is contained in the <TT>implementation</TT> element and holds code that will be carried out when the binding attachment first takes place. If you picture a binding as an object, your vision is initialization code. The code can alternatively be contained as the <TT>action</TT> attribute's value.    This high-level widget uses its <tt>value</tt> attribute to
<H4><A NAME="77482"></A> See Also</H4>    fill in a meter that usually represents how long a particular
destructor    task takes. You can change the <tt>value</tt> attribute
<HR><H3><A NAME="77487"></A> content</H3>    dynamically to update the fill or set the mode to
<P>Container for anonymous content to be inserted into a bound document    "undetermined" (as opposed to the default "determined" mode) to
<A NAME="77487"></A> Contains    display a busy meter that doesn't chart actual progress. 
<TT>children</TT>; any markup  <!--INDEX content element, XBL --> content    <hr>
<A NAME="77487"></A> Contained by    <h3><a name="77253"></a> radio</h3>
binding    <p>Single on/off choice represented as selectable circle <a
<A NAME="77487"></A> Attributes    name="77253"></a> Contained By radiogroup 
id    <!--INDEX radio element, XUL -->
<H4><A NAME="77487"></A> Description</H4>    </p>
This container for the anonymous binding content is placed at the point where the element using it is in the bound document. <TT>children</TT> is the only XBL element allowed as a child of <TT>content</TT>. All other content is either HTML or XUL, depending on the context in which you use the binding.    <h4><a name="77253"></a> Additional Attributes</h4>
<HR><H3><A NAME="77492"></A> destructor</H3>    <tt>selected</tt>, <tt>group</tt>, <tt>label</tt>,
<P>Container for code to be executed when a binding is destroyed    <tt>accesskey</tt>, <tt>value</tt> 
<A NAME="77492"></A> Contained by    <h4><a name="77253"></a> Description</h4>
implementation <!--INDEX destructor element, XBL -->    Within a <tt>radiogroup</tt> element, a single <tt>radio</tt>
<A NAME="77492"></A> Attributes    widget is selected to indicate user choice. <tt>radio</tt>
<TT>action</TT>, <TT>class</TT>, <TT>id</TT>    elements can also be used singularly to check an option on or
<H4><A NAME="77492"></A> Description</H4>    off in the interface. 
Contained in the binding's <TT>implementation</TT>, this element carries out code placed within it when the binding is detached or destroyed. This detachment and destruction occurs when the bound element matches a different style rule, the bound element is removed from the document, or the document is closed or destroyed. The code can alternatively be a value of the <TT>action</TT> attribute.    <hr>
<H4><A NAME="77492"></A> See Also</H4>    <h3><a name="77257"></a> radiogroup</h3>
constructor    <p>Framed box for containing radio elements <a name=
<HR><H3><A NAME="77497"></A> element</H3>    "77257"></a> Contains radio 
<P>Insertion point for bound elements in anonymous content    <!--INDEX radiogroup element, XUL -->
<A NAME="77497"></A> Contained by    </p>
content    <h4><a name="77257"></a> Additional Attributes</h4>
<A NAME="77497"></A> Attributes    disabled 
id    <h4><a name="77257"></a> Description</h4>
<H4><A NAME="77497"></A> Description</H4>    The <tt>radiogroup</tt> makes all <tt>radio</tt> elements
This element allows placement of a  <!--INDEX element element, XBL --> bound element at a point in the anonymous content (other than the top level that is the default for it). To use it, place it at the point in the binding content where you want the bound element to be rendered. This element is part of the XBL 1.0 specification, but is not yet implemented.    within it belong to a single group from which only a single
<H4><A NAME="77497"></A> See Also</H4>    element can be selected. 
content    <hr>
<HR><H3><A NAME="77502"></A> field</H3>    <h3><a name="77261"></a> resizer</h3>
<P>Holder property for simple data    <p>Window-resizing element</p>
<A NAME="77502"></A> Contained by    <h4><a name="77261"></a> Additional Attributes</h4>
implementation <!--INDEX field element, XBL -->    direction <!--INDEX resizer element, XUL -->
<A NAME="77502"></A> Attributes    <h4><a name="77261"></a> Description</h4>
<TT>class</TT>, <TT>id</TT> <TT>name</TT>, <TT>readonly</TT>    A bar that changes the cursor when hovered over to signify that
<H4><A NAME="77502"></A> Description</H4>    the bar can be dragged to resize the a window. The
This element is a simple data holder and an alternative to a <TT>property</TT>. It differs from <TT>property</TT> because it does not use a <TT>getter</TT> or <TT>setter</TT>. It is useful for holding static/constant values for use elsewhere in the binding.    <tt>direction</tt> attribute specifies which way the window is
<H4><A NAME="77502"></A> See Also</H4>    resized, and can have values such as <tt>topleft</tt>,
<TT>implementation</TT>, <TT>property</TT>    <tt>top</tt>, <tt>right</tt>, and <tt>bottomright</tt>. For
<HR><H3><A NAME="77507"></A> getter</H3>    example, a value of <tt>bottomleft</tt> resizes the window down
<P>Script access point for an element's property    and to the left. 
<A NAME="77507"></A> Contained by    <h4><a name="77261"></a> See Also</h4>
property    window 
<A NAME="77507"></A> Attributes    <hr>
<TT>id</TT>, <TT>type</TT>    <h3><a name="77266"></a> row</h3>
<H4><A NAME="77507"></A> Description</H4>    <p>Container for grid cells laid out consecutively <a name=
This element executes script when the <TT>property</TT> it is attached to is accessed. This is most commonly used to return the value of the property.    "77266"></a> Contained By rows <!--INDEX row element, XUL -->
<H4><A NAME="77507"></A> See Also</H4>    </p>
<TT>property</TT>, <TT>setter</TT>    <h4><a name="77266"></a> Additional Attributes</h4>
<HR><H3><A NAME="77512"></A> handler</H3>    None. 
<P>Single event handler for an XBL element    <h4><a name="77266"></a> Description</h4>
<A NAME="77512"></A> Contained by    <tt>row</tt> is a single row in a <tt>grid</tt>. It is
handlers    analogous to the <tt>&lt;TR&gt;</tt> element in HTML. 
<A NAME="77512"></A> Attributes    <h4><a name="77266"></a> See Also</h4>
<TT>id</TT>, <TT>event</TT>, <TT>action</TT>, <TT>phase</TT>, <TT>attachto</TT>, <TT>button</TT>, <TT>modifiers</TT>, <TT>keycode</TT>, <TT>charcode</TT>, <TT>type</TT>    <tt>grid</tt>, <tt>rows</tt> 
<H4><A NAME="77512"></A> Description</H4>    <hr>
This element defines an  <!--INDEX handler element, XBL --> event handler on a binding that reacts to a mouse movement or keyboard press on the binding. Some executed code is contained in the handler. This code can go directly under the element or in the <TT>action</TT> attribute.    <h3><a name="77271"></a> rows</h3>
The <TT>attachto</TT> attribute determines where the event is received-in the element, document, or window. The default receiver is the bound element. The <TT>phase</TT> attribute has three possible values-capturing, bubbling, and target-that determine which part of the event flow and default is bubbling    <p>Definition for grid rows <a name="77271"></a> Contains row 
The <TT>button</TT>, <TT>charcode</TT>, <TT>keycode</TT>, and <TT>modifiers</TT> attributes act as filters. For example, the value of <TT>button</TT> must match the label of the button that triggers the event.    <!--INDEX rows element, XUL -->
The section "Event Attributes," later in this chapter, contains a complete list of events.    </p>
<H4><A NAME="77512"></A> See Also</H4>    <h4><a name="77271"></a> Additional Attributes</h4>
handlers    None. 
<HR><H3><A NAME="77518"></A> handlers</H3>    <h4><a name="77271"></a> Description</h4>
<P>Container for event-handler elements    The <tt>rows</tt> element is a child of the <tt>grid</tt>
<A NAME="77518"></A> Contains    element that contains any number of individual <tt>row</tt>
handler <!--INDEX handlers element, XBL -->    elements. It is a sibling of <tt>columns</tt> within the
<A NAME="77518"></A> Contained by    <tt>grid</tt>. 
binding    <h4><a name="77271"></a> See Also</h4>
<A NAME="77518"></A> Attributes    <tt>grid</tt>, <tt>row</tt>, <tt>columns</tt>, <tt>column</tt> 
<TT>id</TT>, <TT>type</TT>    <hr>
<H4><A NAME="77518"></A> Description</H4>    <h3><a name="77276"></a> rule</h3>
This element is placed under the binding element and contains the event handlers used by that binding.    <p>Defines rules for rendering data as XUL <a name="77276"></a>
<H4><A NAME="77518"></A> See Also</H4>    Contained by template <!--INDEX rule element, XUL -->
handler    </p>
<HR><H3><A NAME="77523"></A> image</H3>    <h4><a name="77276"></a> Additional Attributes</h4>
<P>An image resource in a binding    <tt>rdf:type</tt>, <tt>parent</tt>, <tt>isempty</tt>,
<A NAME="77523"></A> Contained by    <tt>iscontainer</tt> 
resources    <h4><a name="77276"></a> Description</h4>
<A NAME="77523"></A> Attributes    The children of the <tt>rule</tt> element define a rule: the
<TT>class</TT>,<TT>id</TT>, <TT>src</TT>    conditions stated in the <tt>conditions</tt> element must be
<H4><A NAME="77523"></A> Description</H4>    met, the <tt>bindings</tt> provides optional matching, and the
This element preloads images; all included image resources are loaded when the binding is used.    content in the <tt>action</tt> element is rendered if the rule
<H4><A NAME="77523"></A> See Also</H4>    is matched. 
<TT>resources</TT>, <TT>stylesheet</TT>    <h4><a name="77276"></a> See Also</h4>
<HR><H3><A NAME="77529"></A> implementation</H3>    <tt>template</tt>, <tt>action</tt>, <tt>conditions</tt> 
<P>Container for binding methods and properties    <hr>
<A NAME="77529"></A> Contains    <h3><a name="77279"></a> script</h3>
<TT>method</TT>,  <!--INDEX implementation element, XBL --> property    <p>Declaration of script used in XUL file</p>
<A NAME="77529"></A> Contained by    <h4><a name="77279"></a> Additional Attributes</h4>
binding    <tt>src</tt>, type <!--INDEX script element, XUL -->
<A NAME="77529"></A> Attributes    <h4><a name="77279"></a> Description</h4>
<TT>id</TT>, <TT>name</TT>, <TT>implements</TT>, <TT>type</TT>    The <tt>script</tt> element can contain script content (e.g.,
<H4><A NAME="77529"></A> Description</H4>    <tt>&lt;script&gt;alert("it")&lt;/script&gt;</tt>) and can also
This element holds a binding's <TT>&lt;method&gt;</TT> and <TT>&lt;property&gt;</TT> elements that, as a whole, make up a binding's behavior. The optional <TT>implements</TT> attribute can hold a list of comma-separated XPCOM interfaces that are used by the implementation's methods and properties. The optional <TT>type</TT> attribute represents the scripting language to be used. This attribute defaults to JavaScript, the only implemented language that scripts Mozilla's XPFE.    import scripts in JavaScript files, in which case the
<PRE>&lt;implementation type="application/x-javascript" implements="nsIAccessibleProvider"&gt;    <tt>src</tt> attribute is used. The type for JavaScript is
     <tt>application/x-javascript</tt>, and the <tt>src</tt>
     attribute may also use <i>chrome://</i> type URLs to point at
     JavaScript in the chrome. 
     <hr>
     <h3>scrollbar</h3>
     <p>Widget for scrolling in a container Contains
     <tt>scrollbarbutton</tt>, <!--INDEX scrollbar element, XUL -->
     <tt>slider</tt></p>
     <h4><a name="77283"></a> Additional Attributes</h4>
     <tt>curpos</tt>, <tt>increment</tt>, <tt>maxpos</tt>,
     <tt>pageincrement</tt> 
     <h4><a name="77283"></a> Description</h4>
     The <tt>scrollbar</tt> element uses the <tt>curpos</tt> and
     <tt>maxpos</tt> attributes to determine where the
     <tt>scrollbarbutton</tt> element is drawn within its length.
     <tt>increment</tt> specifies how much the scrollbar should move
     on user input. <tt>pageincrement</tt> specifies how many pages
     it should move. 
     <hr>
     <h3><a name="77287"></a> scrollbarbutton</h3>
     <p>Button used to move position of scrollbar thumb <a name=
     "77287"></a> Contained By scrollbar 
     <!--INDEX scrollbarbutton element, XUL -->
     </p>
     <h4><a name="77287"></a> Additional Attributes</h4>
     <tt>sborient</tt>, <tt>type</tt> 
     <h4><a name="77287"></a> Description</h4>
     The <tt>scrollbarbutton</tt> can use its <tt>src</tt> attribute
     to point to an image that should be drawn over it. 
     <hr>
     <h3><a name="77291"></a> scrollbox</h3>
     <p>Box for scrolling content</p>
     <h4><a name="77291"></a> Additional Attributes</h4>
     crop <!--INDEX scrollbox element, XUL -->
     <h4><a name="77291"></a> Description</h4>
     The <tt>scrollbox</tt> is a regular box with scrollbars that
     display automatically when the content inside the box overflows
     the size of the box itself. 
     <h4><a name="77291"></a> See Also</h4>
     <tt>box</tt>, <tt>hbox</tt>, <tt>vbox</tt> 
     <hr>
     <h3><a name="77295"></a> separator</h3>
     <p>Bar between elements</p>
     <h4><a name="77295"></a> Additional Attributes</h4>
     None. 
     <h4><a name="77295"></a> Description</h4>
     The <tt>separator</tt> is a 
     <!--INDEX separator element, XUL --> general-purpose divider.
     In menus, use <tt>menuseparator</tt>. 
     <h4><a name="77295"></a> See Also</h4>
     menuseparator 
     <hr>
     <h3><a name="77299"></a> slider</h3>
     <p>A scrollbar without buttons</p>
     <h4><a name="77299"></a> Additional Attributes</h4>
     <tt>curpos</tt>, <tt>increment</tt>, 
     <!--INDEX slider element, XUL --> <tt>maxpos</tt>,
     <tt>pageincrement</tt> 
     <h4><a name="77299"></a> Description</h4>
     The <tt>slider</tt> element provides simpler user input-a
     <tt>thumb</tt> button and no arrows-for scrolling large
     content. Like <tt>scrollbar</tt>, it uses <tt>curpos</tt> and
     <tt>maxpos</tt> to display its position. 
     <h4><a name="77299"></a> See Also</h4>
     <tt>scrollbar</tt>, <tt>scrollbarbutton</tt> 
     <hr>
     <h3><a name="77302"></a> spacer</h3>
     <p>Blank space separating element</p>
     <h4><a name="77302"></a> Additional Attributes</h4>
     None. <!--INDEX spacer element, XUL -->
     <h4><a name="77302"></a> Description</h4>
     This element is a general-purpose blank space. The use of a
     <tt>spacer</tt> with <tt>flex</tt> to take up available space
     within a <tt>box</tt> and shrink its siblings is a staple of
     the box layout model that XUL uses. 
     <hr>
     <h3><a name="77306"></a> splitter</h3>
     <p>Element for dragging and resizing associated elements</p>
     <h4><a name="77306"></a> Additional Attributes</h4>
     <tt>persist</tt>, <!--INDEX splitter element, XUL --> state 
     <h4><a name="77306"></a> Description</h4>
     Users can drag a <tt>splitter</tt> to resize an associated
     element or panel that holds content and click a
     <tt>splitter</tt> to collapse the specified element within a
     box. To specify which element you manipulate with a
     <tt>splitter</tt>, set this element's <tt>collapse</tt>
     attribute accordingly: <tt>before</tt> to control the element
     before it in the parent; <tt>after</tt> to control the element
     after it. 
     <h4><a name="77306"></a> See Also</h4>
     <tt>grippy</tt>, <tt>toolbar</tt> 
     <hr>
     <h3><a name="77309"></a> stack</h3>
     <p>Shows children one on top of one another, all at the same
     time</p>
     <h4><a name="77309"></a> Description</h4>
     In contrast to the <tt>deck</tt>, <tt>stack</tt> is a
     <tt>box</tt> <!--INDEX stack element, XUL --> that displays all
     of its children at once. You can use a <tt>stack</tt> to
     display elements and blend them together, as when you use
     different stack children as background images and visual
     layers. 
     <h4><a name="77309"></a> See Also</h4>
     <tt>deck</tt>, <tt>box</tt> 
     <hr>
     <h3><a name="77314"></a> statusbar</h3>
     <p>Box container for status elements <a name="77314"></a>
     Contains statusbarpanel <!--INDEX statusbar element, XUL -->
     </p>
     <h4><a name="77314"></a> Additional Attributes</h4>
     None. 
     <h4><a name="77314"></a> Description</h4>
     In Mozilla, the <tt>statusbar</tt> is placed at the bottom of
     the main windows, where it is hooked up to the
     <tt>window.status</tt> property and can be used to display
     status text. It is divided into panels, one of which is the
     <tt>taskbar</tt> where some main component icons are displayed.
     
     <h4><a name="77314"></a> See Also</h4>
     statusbarpanel 
     <hr>
     <h3><a name="77319"></a> statusbarpanel</h3>
     <p>Single unit of a statusbar <a name="77319"></a> Contained by
     statusbar <!--INDEX statusbarpanel element, XUL -->
     </p>
     <h4><a name="77319"></a> Additional Attributes</h4>
     <tt>persist</tt>, <tt>label</tt> 
     <h4><a name="77319"></a> Description</h4>
     <tt>statusbarpanel</tt>s are subdivisions of the
     <tt>statusbar</tt> at the bottom of main browser windows. They
     can contain other content, text using the <tt>label</tt>
     attribute and an image using the <tt>list-style-image</tt> CSS
     style rule. 
     <h4><a name="77319"></a> See Also</h4>
     statusbar 
     <hr>
     <h3><a name="77324"></a> stringbundle</h3>
     <p>Holder of localized properties for use in script <a name=
     "77324"></a> Contained by stringbundleset 
     <!--INDEX stringbundle element, XUL -->
     </p>
     <h4><a name="77324"></a> Additional Attributes</h4>
     src 
     <h4><a name="77324"></a> Description</h4>
     Like the <tt>script</tt> element, <tt>stringbundle</tt> uses
     the <tt>src</tt> attribute to locate a file for use. In this
     case, the files is a string bundle (properties file) that is
     used for holding localizable strings used in the UI. 
     <h4><a name="77324"></a> See Also</h4>
     stringbundleset 
     <hr>
     <h3><a name="77329"></a> stringbundleset</h3>
     <p>Container for stringbundle elements <a name="77329"></a>
     Contains stringbundle 
     <!--INDEX stringbundleset element, XUL -->
     </p>
     <h4><a name="77329"></a> Additional Attributes</h4>
     None. 
     <h4><a name="77329"></a> Description</h4>
     <tt>stringbundleset</tt> is an optional container for groups of
     <tt>stringbundle</tt> elements. Like <tt>commandset</tt> use
     for commands, <tt>stringbundle</tt> organizes sets of related
     <tt>stringbundle</tt>s, particularly when those sets are
     overlaid into the UI. 
     <h4><a name="77329"></a> See Also</h4>
     stringbundle 
     <hr>
     <h3><a name="77334"></a> tab</h3>
     <p>A single selectable tab of a tabbox <a name="77334"></a>
     Contained by tabs</p>
     <h4><a name="77334"></a> Additional Attributes</h4>
     <tt>accesskey</tt>, <!--INDEX tab element, XUL -->
     <tt>crop</tt>, <tt>disabled</tt>, <tt>label</tt>,
     <tt>image</tt> 
     <h4><a name="77334"></a> Description</h4>
     Individual tabs correspond to panels in the <tt>tabbox</tt>. 
     <h4><a name="77334"></a> See Also</h4>
     <tt>tabbox</tt>, <tt>tabpanel</tt>, <tt>tabpanels</tt>,
     <tt>tabs</tt> 
     <hr>
     <h3>tabbox</h3>
     <p>Box container for tab panels Contains <tt>tabs</tt>,
     tabpanels <!--INDEX tabbox element, XUL -->
     </p>
     <h4><a name="77339"></a> Additional Attributes</h4>
     None. 
     <h4><a name="77339"></a> Description</h4>
     <tt>tabbox</tt> is the container in which the tabs and
     tabpanels are defined. It lays out children like a regular box
     to the orientation specified, which defaults to vertical. The
     panels are defined in the <tt>tabpanels</tt> element. 
     <h4><a name="77339"></a> See Also</h4>
     <tt>tab</tt>, <tt>tabpanel</tt>, <tt>tabpanels</tt>,
     <tt>tabs</tt> 
     <hr>
     <h3><a name="77343"></a> tabbrowser</h3>
     <p>Tabbed holder for a set of web content views</p>
     <h4><a name="77343"></a> Additional Attributes</h4>
     <tt>contentcontextmenu</tt>, 
     <!--INDEX tabbrowser element, XUL --> <tt>contenttooltip</tt> 
     <h4><a name="77343"></a> Description</h4>
     <tt>tabbrowser</tt> derives from the <tt>browser</tt> widget.
     Like <tt>browser</tt>, it lets you view HTML pages and other
     content. <tt>tabbrowser</tt> has additional methods on it that
     manage tabbed windows (e.g., <tt>addTab</tt>,
     <tt>enterTabbedMode</tt>). 
     <h4><a name="77343"></a> See Also</h4>
     browser 
     <hr>
     <h3><a name="77349"></a> tabpanel</h3>
     <p>A single panel of a tabbox <a name="77349"></a> Contained by
     tabpanels <!--INDEX tabpanel element, XUL -->
     <a name="77349"></a> Contains XUL content</p>
     <h4><a name="77349"></a> Additional Attributes</h4>
     None. 
     <h4><a name="77349"></a> Description</h4>
     A <tt>tabpanel</tt> is one of the special <tt>box</tt> elements
     that correspond to a particular tab within a <tt>tabbox</tt>.
     It can hold any XUL content to be displayed on a particular tab
     panel. 
     <h4><a name="77349"></a> See Also</h4>
     <tt>tab</tt>, <tt>tabbox</tt>, <tt>tabpanels</tt>,
     <tt>tabs</tt> 
     <hr>
     <h3><a name="77355"></a> tabpanels</h3>
     <p>Container for tabpanel elements <a name="77355"></a>
     Contained by tabbox <!--INDEX tabpanels element, XUL -->
     <a name="77355"></a> Contains <tt>tabpanel</tt>,
     <tt>box</tt></p>
     <h4><a name="77355"></a> Additional Attributes</h4>
     None. 
     <h4><a name="77355"></a> Description</h4>
     The <tt>tabpanels</tt> container corresponds to the
     <tt>tabs</tt> element that holds all individual tabs, and is a
     container for the <tt>tabpanel</tt> associated with that tab.
     This child panel can be either an optional <tt>tabpanel</tt>
     element that holds XUL content, or just the XUL content. 
     <h4><a name="77355"></a> See Also</h4>
     <tt>tab</tt>, <tt>tabbox</tt>, <tt>tabpanel</tt>, <tt>tabs</tt>
     
     <hr>
     <h3><a name="77361"></a> tabs</h3>
     <p>Container for tab elements <a name="77361"></a> Contained by
     tabbox <!--INDEX tabs element, XUL -->
     <a name="77361"></a> Contains tab</p>
     <h4><a name="77361"></a> Additional Attributes</h4>
     None. 
     <h4><a name="77361"></a> Description</h4>
     This element is a required container for individual tabs. 
     <h4><a name="77361"></a> See Also</h4>
     <tt>tab</tt>, <tt>tabbox</tt>, <tt>tabpanel</tt>,
     <tt>tabpanels</tt> 
     <hr>
     <h3><a name="77365"></a> template</h3>
     <p>A high-level widget used to build content dynamically from
     data <a name="77365"></a> Contains rule 
     <!--INDEX template element, XUL -->
     </p>
     <h4><a name="77365"></a> Additional Attributes</h4>
     <tt>xmlns:nc</tt>, <tt>xmlns:chrome</tt> 
     <h4><a name="77365"></a> Description</h4>
     The <tt>template</tt> element has several <tt>rule</tt>
     children, each of which defines rules for matching data in a
     datasource and rendering that data as XUL content. A template
     is defined within the regular XUL content. 
     <hr>
     <h3><a name="77369"></a> textbox</h3>
     <p>Accepts text input from user</p>
     <h4><a name="77369"></a> Additional Attributes</h4>
     <tt>multiline</tt>, <tt><!--INDEX textbox element, XUL -->
     maxlength</tt>, <tt>disabled</tt>, <tt>readonly</tt>,
     <tt>type</tt>, <tt>size</tt> 
     <h4><a name="77369"></a> Description</h4>
     <tt>textbox</tt> is a user-input element. Expand it beyond its
     single-line default by setting <tt>multiline</tt> to
     <tt>true</tt>. You can also disable it, and set its size. 
     <h4><a name="77369"></a> See Also</h4>
     label 
     <hr>
     <h3><a name="77373"></a> thumb</h3>
     <p>Object used to move content in scrollable area</p>
     <h4><a name="77373"></a> Additional Attributes</h4>
     sborient <!--INDEX thumb element, XUL -->
     <h4><a name="77373"></a> Description</h4>
     The <tt>thumb</tt> element appears in the <tt>slider</tt> and
     the <tt>scrollbar</tt>. 
     <h4><a name="77373"></a> See Also</h4>
     <tt>scrollbar</tt>, <tt>scrollbarbutton</tt>, <tt>slider</tt> 
     <hr>
     <h3><a name="77378"></a> toolbar</h3>
     <p>Holder of buttons for quick-access UI functionality <a name=
     "77378"></a> Contains <tt>toolbarbutton</tt>, 
     <!--INDEX toolbar element, XUL -->
     <tt>toolbarseparator</tt></p>
     <h4><a name="77378"></a> Additional Attributes</h4>
     <tt>grippyhidden</tt>, <tt>tborient</tt>, <tt>tbalign</tt>,
     <tt>tbpack</tt> 
     <h4><a name="77378"></a> Description</h4>
     Toolbars usually have horizontal orientation at the top of an
     application window, but this does not have to be the case. You
     can use the <tt>orient</tt> attribute to set it vertically and
     run its content down and not across. While the most common
     content for a toolbar is buttons and menus, it can contain any
     type of content. 
     <h4><a name="77378"></a> See Also</h4>
     <tt>toolbarbutton</tt>, <tt>toolbarseparator</tt>,
     <tt>toolbox</tt> 
     <hr>
     <h3><a name="77383"></a> toolbarbutton</h3>
     <p>Specially adapted button for use in a toolbar <a name=
     "77383"></a> Contained by toolbar 
     <!--INDEX toolbarbutton element, XUL -->
     </p>
     <h4><a name="77383"></a> Additional Attributes</h4>
     <tt>accesskey</tt>, <tt>dir</tt>, <tt>disabled</tt>,
     <tt>dlgType</tt>, <tt>group</tt>, <tt>image</tt>,
     <tt>label</tt>, <tt>orient</tt>, <tt>type</tt>, <tt>value</tt> 
     <h4><a name="77383"></a> Description</h4>
     This is a button designed especially for a toolbar, with
     special stylings for this purpose. The current theme determines
     a <tt>toolbarbutton</tt>'s look. See <i>toolbar.css</i> in the
     theme JARs to view styles and bindings for this common button. 
     <h4><a name="77383"></a> See Also</h4>
     <tt>toolbar</tt>, <tt>toolbarseparator</tt>, <tt>toolbox</tt> 
     <hr>
     <h3><a name="77388"></a> toolbarseparator</h3>
     <p>Visible separator for elements contained in a toolbar <a
     name="77388"></a> Contained by toolbar 
     <!--INDEX toolbarseparator element, XUL -->
     </p>
     <h4><a name="77388"></a> Additional Attributes</h4>
     None. 
     <h4><a name="77388"></a> Description</h4>
     Like the <tt>menuseparator</tt> in a <tt>menu</tt>,
     <tt>toolbarseparator</tt> divides elements in a
     <tt>toolbar</tt>. 
     <h4><a name="77388"></a> See Also</h4>
     <tt>toolbar</tt>, <tt>toolbarbutton</tt>, <tt>toolbox</tt> 
     <hr>
     <h3><a name="77393"></a> toolbox</h3>
     <p>Optional container for menu bars and toolbars <a name=
     "77393"></a> Contains <tt>menubar</tt>, 
     <!--INDEX toolbox element, XUL --> <tt>toolbar</tt></p>
     <h4><a name="77393"></a> Additional Attributes</h4>
     None. 
     <h4><a name="77393"></a> Description</h4>
     <tt>toolbox</tt> can organize several toolbars into one parent
     element. <tt>toolbox</tt> inherits from <tt>box</tt>, so you
     can use box layout attributes to control the positioning and
     layout of toolbars within. 
     <h4><a name="77393"></a> See Also</h4>
     <tt>menubar</tt>, <tt>toolbar</tt> 
     <hr>
     <h3><a name="77396"></a> tooltip</h3>
     <p>Pop-up window for context-sensitive help</p>
     <h4><a name="77396"></a> Additional Attributes</h4>
     <tt>noautohide</tt>, <!--INDEX tooltip element, XUL -->
     <tt>onpopupshowing</tt>, <tt>onpopuphiding</tt>,
     <tt>position</tt> 
     <h4><a name="77396"></a> Description</h4>
     The <tt>tooltip</tt> element defines text to be displayed. It
     is associated by <tt>ID</tt> with elements that want to use its
     content in the pop ups they display. However, elements can also
     use the <tt>tooltip</tt> attribute to display a tooltip more
     directly for themselves. 
     <hr>
     <h3><a name="77401"></a> tree</h3>
     <p>Hierarchical holder of information represented as rows <a
     name="77401"></a> Contains <tt>treecols</tt>,
     <tt>treechildren</tt></p>
     <h4><a name="77401"></a> Additional Attributes</h4>
     <tt>multiple</tt>, <!--INDEX tree element, XUL -->
     <tt>datasources</tt>, <tt>enableColumnDrag</tt>,
     <tt>containment</tt>, <tt>sortResource</tt>,
     <tt>sortDirection</tt>, <tt>border</tt>, <tt>seltype</tt>,
     <tt>sortActive</tt>, <tt>flags, context</tt>, <tt>persist</tt>,
     <tt>hidecolumnpicker</tt> 
     <h4><a name="77401"></a> Description</h4>
     The <tt>tree</tt> element is a high-level widget that displays
     tabular data. More complex than <tt>listbox</tt>, <tt>tree</tt>
     allows you to define nested content, different views, and data
     display, and provides methods that sort and manipulate its
     contents. 
     <h4><a name="77401"></a> See Also</h4>
     <tt>treecell</tt>, <tt>treechildren</tt>, <tt>treecol</tt>,
     <tt>treecols</tt>, <tt>treeitem</tt>, <tt>treerow</tt> 
     <hr>
     <h3><a name="77406"></a> treecell</h3>
     <p>A single cell in a tree <a name="77406"></a> Contained by
     treerow</p>
     <h4><a name="77406"></a> Additional Attributes</h4>
     <tt>src</tt>, <tt>indent</tt>, 
     <!--INDEX treecell element, XUL --> <tt>observes</tt>,
     <tt>url</tt>, <tt>value</tt>, <tt>label</tt>, <tt>sortActive,
     sortDirection</tt>, <tt>tag</tt>, <tt>mode</tt>,
     <tt>resource</tt>, <tt>allowevents</tt>, <tt>properties</tt> 
     <h4><a name="77406"></a> Description</h4>
     The <tt>treecell</tt> contains the actual content to be
     displayed in a tree. That content can be in the form of a value
     for the <tt>label</tt> attribute. It can also be content in the
     <tt>treecell</tt>'s start and end tags (e.g.,
     <tt>&lt;treecell&gt;data&lt;/treecell&gt;</tt>). 
     <h4><a name="77406"></a> See Also</h4>
     tree, treechildren, treecol, treecols, treeitem, treerow 
     <hr>
     <h3><a name="77412"></a> treechildren</h3>
     <p>The main body of a tree; a container for treeitems <a name=
     "77412"></a> Contains treeitem 
     <!--INDEX treechildren element, XUL -->
     <a name="77412"></a> Contained by tree</p>
     <h4><a name="77412"></a> Additional Attributes</h4>
     open 
     <h4><a name="77412"></a> Description</h4>
     The <tt>treechildren</tt> element defines the subset of the
     <tt>tree</tt> where the content is actually contained (in
     contrast to <tt>treecols</tt>, which defines aspects of the
     layout). 
     <h4><a name="77412"></a> See Also</h4>
     <tt>tree</tt>, <tt>treecell</tt>, <tt>treecol</tt>,
     <tt>treecols</tt>, <tt>treeitem</tt>, <tt>treerow</tt> 
     <hr>
     <h3><a name="77417"></a> treecol</h3>
     <p>A single column of a tree <a name="77417"></a> Contained by
     treecols <!--INDEX treecol element, XUL -->
     </p>
     <h4><a name="77417"></a> Additional Attributes</h4>
     <tt>sort</tt>, <tt>resource</tt>, <tt>primary</tt>,
     <tt>sortSeparators</tt>, <tt>label</tt>, <tt>sortActive</tt>,
     <tt>sortDirection</tt>, <tt>hideheader</tt>,
     <tt>accesskey</tt>, <tt>type</tt> 
     <h4><a name="77417"></a> Description</h4>
     The <tt>treecol</tt> typically does not contain content.
     Instead, it defines the header for the columns whose contents
     are defined in the <tt>treerow</tt>s. 
     <h4><a name="77417"></a> See Also</h4>
     <tt>tree</tt>, <tt>treecell</tt>, <tt>treechildren</tt>,
     <tt>treecols</tt>, <tt>treeitem</tt>, <tt>treerow</tt> 
     <hr>
     <h3><a name="77423"></a> treecols</h3>
     <p>Container for tree columns <a name="77423"></a> Contained by
     tree <a name="77423"></a> Contains treecol</p>
     <h4><a name="77423"></a> Additional Attributes</h4>
     None. 
     <h4><a name="77423"></a> Description</h4>
     This element is a container for a group of <tt>treecol</tt>
     elements, or columns, in a tree. A tree should have only one
     <tt>treecols</tt>. 
     <h4><a name="77423"></a> See Also</h4>
     <tt>tree</tt>, <tt>treecell</tt>, <tt>treechildren</tt>,
     <tt>treecol</tt>, <tt>treeitem</tt>, <tt>treerow</tt> 
     <hr>
     <h3><a name="77429"></a> treeitem</h3>
     <p>A treerow container <a name="77429"></a> Contained by
     treechildren <!--INDEX treeitem element, XUL -->
     <a name="77429"></a> Contains treerow</p>
     <h4><a name="77429"></a> Additional Attributes</h4>
     <tt>rdf:type</tt>, <tt>container</tt>, <tt>open</tt> 
     <h4><a name="77429"></a> Description</h4>
     The <tt>treeitem</tt> element is a container for a
     <tt>treerow</tt>, and makes <tt>treerow</tt> a selectable
     element within the <tt>tree</tt>. 
     <h4><a name="77429"></a> See Also</h4>
     <tt>tree</tt>, <tt>treecell</tt>, <tt>treechildren</tt>,
     <tt>treecol</tt>, <tt>treecols</tt>, <tt>treerow</tt> 
     <hr>
     <h3><a name="77435"></a> treerow</h3>
     <p>A single row of a tree <a name="77435"></a> Contained by
     treeitem <!--INDEX treerow element, XUL -->
     <a name="77435"></a> Contains treecell</p>
     <h4><a name="77435"></a> Additional Attributes</h4>
     properties 
     <h4><a name="77435"></a> Description</h4>
     Contained within a <tt>treeitem</tt>, this element represents a
     single row of a tree. 
     <h4><a name="77435"></a> See Also</h4>
     <tt>tree</tt>, <tt>treecell</tt>, <tt>treechildren</tt>,
     <tt>treecol</tt>, <tt>treecols</tt>, <tt>treeitem</tt> 
     <hr>
     <h3><a name="77439"></a> triple</h3>
     <p>Substructure of a template that matches RDF statements in
     the data</p>
     <h4><a name="77439"></a> Additional Attributes</h4>
     <tt>predicate</tt>, <!--INDEX triple element, XUL -->
     <tt>object</tt>, <tt>subject</tt> 
     <h4><a name="77439"></a> Description</h4>
     The children of <tt>triple-predicate</tt>, <tt>object</tt>, and
     <tt>subject-</tt>match RDF statements that appear in the data
     processed in the template. 
     <h4><a name="77439"></a> See Also</h4>
     <tt>template</tt>, <tt>member</tt>, <tt>content</tt>,
     <tt>conditions</tt> 
     <hr>
     <h3><a name="77442"></a> vbox</h3>
     <p>Box container with vertically laid out children</p>
     <h4><a name="77442"></a> Additional Attributes</h4>
     None. 
     <h4><a name="77442"></a> See Also</h4>
     <tt>box</tt>, <!--INDEX vbox element, XUL --> hbox 
     <hr>
     <h3><a name="77446"></a> window</h3>
     <p>Root element of a top-level XUL window document</p>
     <h4><a name="77446"></a> Additional Attributes</h4>
     <tt>windowtype</tt>, <tt><!--INDEX window element, XUL -->
     xmlns:rdf</tt>, <tt>xmlns:web</tt>, <tt>titlepreface</tt>,
     <tt>onload</tt>, <tt>onunload</tt>, <tt>xmlns</tt>,
     <tt>titlemodifier</tt>, <tt>xmlns:html</tt>, <tt>title</tt>,
     <tt>onclose</tt>, <tt>titlemenuseparator</tt>,
     <tt>contenttitlesetting</tt>, <tt>y</tt>, <tt>x</tt>,
     <tt>screenY</tt>, <tt>screenX</tt> 
     <h4><a name="77446"></a> Description</h4>
     The <tt>window</tt> is an XUL document's basic root element.
     The contents of a XUL document, including the <tt>script</tt>
     elements, commands, keys, and broadcasters, appear as children
     of the window. Overlays, the XML and stylesheet-processing
     instructions, and the <tt>DOCTYPE</tt> declaration appear
     before and outside a document's root element. The window should
     have a unique ID and use minimally, the XUL namespace to
     identify markup elements as XUL: <tt>xmlns="<a href=
     "http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
     http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</a>"</tt>.
     
     <h4><a name="77446"></a> See Also</h4>
     <tt>overlay</tt>, <tt>page</tt> 
     <hr>
     <h3><a name="77451"></a> wizard</h3>
     <p>Window used to step though a task <a name="77451"></a>
     Contains wizardpage</p>
     <h4><a name="77451"></a> Additional Attributes</h4>
     <tt>onwizardaccept</tt>, <tt>onwizardcancel</tt>,
     <tt>xmlns</tt>, <tt>onwizardfinish</tt>, <tt>xmlns:nc</tt> 
     <h4><a name="77451"></a> Description</h4>
     Like <tt>dialog</tt>, <tt>wizard</tt> is a specialized version
     of the <tt>window</tt> root element. It easily creates
     multistep dialog windows that help users set up accounts,
     password data, and other customizable information. A
     <tt>wizard</tt> contains one or more <tt>wizardpage</tt>s. 
     <h4><a name="77451"></a> See Also</h4>
     <tt>wizardpage</tt>, <tt>window</tt>, <tt>dialog</tt> 
     <hr>
     <h3><a name="77456"></a> wizardpage</h3>
     <p>A single panel (step) of a wizard <a name="77456"></a>
     Contained by wizard</p>
     <h4><a name="77456"></a> Additional Attributes</h4>
     <tt>label</tt>, <tt>pageid</tt>, <tt>onpageadvanced</tt>,
     <tt>onpageshow</tt>, <tt>onpagecancel</tt> 
     <h4><a name="77456"></a> Description</h4>
     The <tt>wizardpage</tt> can contain 
     <!--INDEX wizardpage element, XUL --> arbitrary XUL content.
     One or more wizardpages are defined in a <tt>wizard</tt>
     window. The intrinsic functionality of a wizard window allows
     you to step through <tt>wizardpage</tt>s by setting the
     <tt>onpageshow</tt> and <tt>onpagecancel</tt> event handlers on
     individual pages and using the <tt>onwizardaccept</tt> and
     <tt>onwizardcancel</tt> event handlers on 
     <!--INDEX ENDRANGE==XUL element set --> the 
     <!--INDEX ENDRANGE==elements:XUL element set -->
     <tt>wizard</tt> parent element. 
     <h4><a name="77456"></a> See Also</h4>
     <tt>wizard</tt>, <tt>window</tt>, <tt>dialog</tt> 
     <h2><a name="77457"></a> XBL Element Set</h2>
     <p>The XBL 1.0 specification published on the 
     <!--INDEX STARTRANGE==XBL element set;elements:XBL element set -->
     mozilla.org web site appeared to be a beacon for application
     developers. Because the specification was available early in
     the development process, XBL seemed to be a tighter, more
     comprehensible language that was easier to learn and master
     than XUL. Since then, XBL development has strayed from the
     specification quite a bit, however, and now people consider XBL
     as opaque as XUL without good documentation that helps people
     learn and to create a roadmap for use based on continuing
     development.</p>
     <p>This reference section tries to capture basic elements and
     attributes in XBL. Because it binds rather than creates
     content, XBL is smaller and inherently more formal than XUL.
     Nonetheless, as you will see, the language has quite a bit of
     range and complexity. Each entry in this section describes the
     XBL element and its purpose, its position in the hierarchy
     (i.e., which elements it contains and which elements it is
     contained by), and lists the element's attributes. <a href=
     "ch07.html#77027">Chapter 7</a> introduces XBL and shows how to
     use it. However, once you are familiar with the basics of XBL,
     you can consult this reference to find the XBL items you
     want.</p>
     <hr>
     <h3><a name="77463"></a> binding</h3>
     <p>A single XBL binding <a name="77463"></a> Contains
     <tt>content</tt>, <tt>implementation</tt>, 
     <!--INDEX binding element, XBL --> handlers <a name=
     "77463"></a> Contained by bindings <a name="77463"></a>
     Attributes <tt>id</tt>, <tt>extends</tt>, <tt>display</tt>,
     <tt>applyauthorstyles</tt>, <tt>styleexplicitcontent</tt></p>
     <h4><a name="77463"></a> Description</h4>
     This element defines a single XBL binding that can be attached
     to a bound document. It enables the creation of self-contained
     widgets that can contain content, implementation, and handlers.
     This element must have an <tt>id</tt> attribute value; this
     value is how it is associated-either through a CSS style rule
     or a DOM method-to the bound element that acts a placeholder
     for the binding that is filled out during attachment. The
     <tt>extends</tt> attribute inherits from a XUL element or
     another binding. 
     <h4><a name="77463"></a> See Also</h4>
     bindings 
     <hr>
     <h3><a name="77468"></a> bindings</h3>
     <p>An XBL document's root element <a name="77468"></a> Contains
     <tt>binding</tt>, <tt>resources</tt>, 
     <!--INDEX bindings element, XBL --> stylesheet <a name=
     "77468"></a> Attributes <tt>id</tt>, <tt>type</tt></p>
     <h4><a name="77468"></a> Description</h4>
     This root container can hold one or more bindings, represented
     by the <tt>&lt;binding&gt;</tt> markup. The Mozilla code base
     references an XBL document through its name, which has an
     <i>.xml</i> extension. The document <tt>id</tt> has to be
     unique. The other children of <tt>&lt;bindings&gt;</tt> are
     <tt>&lt;resources&gt;</tt> and <tt>&lt;stylesheet&gt;</tt>,
     which contain style and image information to be used by the
     document's bindings. 
     <h4><a name="77468"></a> See Also</h4>
     binding 
     <hr>
     <h3><a name="77473"></a> body</h3>
     <p>Container for JavaScript code to be executed by an XBL
     method <a name="77473"></a> Contained by method 
     <!--INDEX body element, XBL -->
     <a name="77473"></a> Attributes id</p>
     <h4><a name="77473"></a> Description</h4>
     This element is designed as a holder for the method's script.
     It defines a logical block and differentiates the script from
     the parameter element, which also lies within the method.
     Script contained in a method has to be in a body element, which
     in turn should contain a CDATA section. &lt;![CDATA[...]]&gt;
     escapes JavaScript characters like quotes and slashes that may
     otherwise conflict with the XML parser. 
     <h4><a name="77473"></a> See Also</h4>
     method 
     <hr>
     <h3><a name="77477"></a> children</h3>
     <p>Insertion point for children of a bound element, or
     inherited binding <a name="77477"></a> Contained by content 
     <!--INDEX children element, XBL -->
     <a name="77477"></a> Attributes <tt>id</tt>, <tt>includes</tt>,
     <tt>type</tt></p>
     <h4><a name="77477"></a> Description</h4>
     This element needs to be placed in the binding content at the
     point where you want to place children of the bound element
     when the binding is rendered. If the children tag contains its
     own elements, then that element will be default content. If the
     element the binding attaches to contains children, the default
     content is ignored. 
     <hr>
     <h3><a name="77482"></a> constructor</h3>
     <p>Container for code to be executed when a binding is created
     <a name="77482"></a> Contained by implementation 
     <!--INDEX constructor element, XBL -->
     <a name="77482"></a> Attributes <tt>action</tt>,
     <tt>class</tt>, <tt>id</tt></p>
     <h4><a name="77482"></a> Description</h4>
     This behavior element is contained in the
     <tt>implementation</tt> element and holds code that will be
     carried out when the binding attachment first takes place. If
     you picture a binding as an object, your vision is
     initialization code. The code can alternatively be contained as
     the <tt>action</tt> attribute's value. 
     <h4><a name="77482"></a> See Also</h4>
     destructor 
     <hr>
     <h3><a name="77487"></a> content</h3>
     <p>Container for anonymous content to be inserted into a bound
     document <a name="77487"></a> Contains <tt>children</tt>; any
     markup <!--INDEX content element, XBL --> content <a name=
     "77487"></a> Contained by binding <a name="77487"></a>
     Attributes id</p>
     <h4><a name="77487"></a> Description</h4>
     This container for the anonymous binding content is placed at
     the point where the element using it is in the bound document.
     <tt>children</tt> is the only XBL element allowed as a child of
     <tt>content</tt>. All other content is either HTML or XUL,
     depending on the context in which you use the binding. 
     <hr>
     <h3><a name="77492"></a> destructor</h3>
     <p>Container for code to be executed when a binding is
     destroyed <a name="77492"></a> Contained by implementation 
     <!--INDEX destructor element, XBL -->
     <a name="77492"></a> Attributes <tt>action</tt>,
     <tt>class</tt>, <tt>id</tt></p>
     <h4><a name="77492"></a> Description</h4>
     Contained in the binding's <tt>implementation</tt>, this
     element carries out code placed within it when the binding is
     detached or destroyed. This detachment and destruction occurs
     when the bound element matches a different style rule, the
     bound element is removed from the document, or the document is
     closed or destroyed. The code can alternatively be a value of
     the <tt>action</tt> attribute. 
     <h4><a name="77492"></a> See Also</h4>
     constructor 
     <hr>
     <h3><a name="77497"></a> element</h3>
     <p>Insertion point for bound elements in anonymous content <a
     name="77497"></a> Contained by content <a name="77497"></a>
     Attributes id</p>
     <h4><a name="77497"></a> Description</h4>
     This element allows placement of a 
     <!--INDEX element element, XBL --> bound element at a point in
     the anonymous content (other than the top level that is the
     default for it). To use it, place it at the point in the
     binding content where you want the bound element to be
     rendered. This element is part of the XBL 1.0 specification,
     but is not yet implemented. 
     <h4><a name="77497"></a> See Also</h4>
     content 
     <hr>
     <h3><a name="77502"></a> field</h3>
     <p>Holder property for simple data <a name="77502"></a>
     Contained by implementation <!--INDEX field element, XBL -->
     <a name="77502"></a> Attributes <tt>class</tt>, <tt>id</tt>
     <tt>name</tt>, <tt>readonly</tt></p>
     <h4><a name="77502"></a> Description</h4>
     This element is a simple data holder and an alternative to a
     <tt>property</tt>. It differs from <tt>property</tt> because it
     does not use a <tt>getter</tt> or <tt>setter</tt>. It is useful
     for holding static/constant values for use elsewhere in the
     binding. 
     <h4><a name="77502"></a> See Also</h4>
     <tt>implementation</tt>, <tt>property</tt> 
     <hr>
     <h3><a name="77507"></a> getter</h3>
     <p>Script access point for an element's property <a name=
     "77507"></a> Contained by property <a name="77507"></a>
     Attributes <tt>id</tt>, <tt>type</tt></p>
     <h4><a name="77507"></a> Description</h4>
     This element executes script when the <tt>property</tt> it is
     attached to is accessed. This is most commonly used to return
     the value of the property. 
     <h4><a name="77507"></a> See Also</h4>
     <tt>property</tt>, <tt>setter</tt> 
     <hr>
     <h3><a name="77512"></a> handler</h3>
     <p>Single event handler for an XBL element <a name="77512"></a>
     Contained by handlers <a name="77512"></a> Attributes
     <tt>id</tt>, <tt>event</tt>, <tt>action</tt>, <tt>phase</tt>,
     <tt>attachto</tt>, <tt>button</tt>, <tt>modifiers</tt>,
     <tt>keycode</tt>, <tt>charcode</tt>, <tt>type</tt></p>
     <h4><a name="77512"></a> Description</h4>
     This element defines an <!--INDEX handler element, XBL -->
     event handler on a binding that reacts to a mouse movement or
     keyboard press on the binding. Some executed code is contained
     in the handler. This code can go directly under the element or
     in the <tt>action</tt> attribute. The <tt>attachto</tt>
     attribute determines where the event is received-in the
     element, document, or window. The default receiver is the bound
     element. The <tt>phase</tt> attribute has three possible
     values-capturing, bubbling, and target-that determine which
     part of the event flow and default is bubbling The
     <tt>button</tt>, <tt>charcode</tt>, <tt>keycode</tt>, and
     <tt>modifiers</tt> attributes act as filters. For example, the
     value of <tt>button</tt> must match the label of the button
     that triggers the event. The section "Event Attributes," later
     in this chapter, contains a complete list of events. 
     <h4><a name="77512"></a> See Also</h4>
     handlers 
     <hr>
     <h3><a name="77518"></a> handlers</h3>
     <p>Container for event-handler elements <a name="77518"></a>
     Contains handler <!--INDEX handlers element, XBL -->
     <a name="77518"></a> Contained by binding <a name="77518"></a>
     Attributes <tt>id</tt>, <tt>type</tt></p>
     <h4><a name="77518"></a> Description</h4>
     This element is placed under the binding element and contains
     the event handlers used by that binding. 
     <h4><a name="77518"></a> See Also</h4>
     handler 
     <hr>
     <h3><a name="77523"></a> image</h3>
     <p>An image resource in a binding <a name="77523"></a>
     Contained by resources <a name="77523"></a> Attributes
     <tt>class</tt>,<tt>id</tt>, <tt>src</tt></p>
     <h4><a name="77523"></a> Description</h4>
     This element preloads images; all included image resources are
     loaded when the binding is used. 
     <h4><a name="77523"></a> See Also</h4>
     <tt>resources</tt>, <tt>stylesheet</tt> 
     <hr>
     <h3><a name="77529"></a> implementation</h3>
     <p>Container for binding methods and properties <a name=
     "77529"></a> Contains <tt>method</tt>, 
     <!--INDEX implementation element, XBL --> property <a name=
     "77529"></a> Contained by binding <a name="77529"></a>
     Attributes <tt>id</tt>, <tt>name</tt>, <tt>implements</tt>,
     <tt>type</tt></p>
     <h4><a name="77529"></a> Description</h4>
     This element holds a binding's <tt>&lt;method&gt;</tt> and
     <tt>&lt;property&gt;</tt> elements that, as a whole, make up a
     binding's behavior. The optional <tt>implements</tt> attribute
     can hold a list of comma-separated XPCOM interfaces that are
     used by the implementation's methods and properties. The
     optional <tt>type</tt> attribute represents the scripting
     language to be used. This attribute defaults to JavaScript, the
     only implemented language that scripts Mozilla's XPFE. 
 <pre>
 &lt;implementation type="application/x-javascript" implements="nsIAccessibleProvider"&gt;
 ...  ...
&lt;/implementation&gt;</PRE>&lt;/implementation&gt;
<H4><A NAME="77529"></A> See Also</H4></pre>
<TT>binding</TT>, <TT>method</TT>, <TT>property</TT>    <h4><a name="77529"></a> See Also</h4>
<HR><H3><A NAME="77535"></A> method</H3>    <tt>binding</tt>, <tt>method</tt>, <tt>property</tt> 
<P>Script function to be accessed on a binding object    <hr>
<A NAME="77535"></A> Contains    <h3><a name="77535"></a> method</h3>
<TT>body</TT>,  <!--INDEX method element, XBL --> parameter    <p>Script function to be accessed on a binding object <a name=
<A NAME="77535"></A> Contained by    "77535"></a> Contains <tt>body</tt>, 
implementation    <!--INDEX method element, XBL --> parameter <a name=
<A NAME="77535"></A> Attributes    "77535"></a> Contained by implementation <a name="77535"></a>
<TT>id</TT>, <TT>name</TT>, <TT>type</TT>    Attributes <tt>id</tt>, <tt>name</tt>, <tt>type</tt></p>
<H4><A NAME="77535"></A> Description</H4>    <h4><a name="77535"></a> Description</h4>
This element supplies a single function to the bound element or binding object. The most important attribute is <TT>name</TT>, which calls the method and is compulsory. The method can have the <TT>&lt;parameter&gt;</TT> element define parameters. A <TT>&lt;body&gt;</TT> element contains the code that will be executed.    This element supplies a single function to the bound element or
<H4><A NAME="77535"></A> See Also</H4>    binding object. The most important attribute is <tt>name</tt>,
<TT>body</TT>, <TT>implementation</TT>, <TT>parameter</TT>    which calls the method and is compulsory. The method can have
<HR><H3><A NAME="77540"></A> parameter</H3>    the <tt>&lt;parameter&gt;</tt> element define parameters. A
<P>Single paramter declaration for a method    <tt>&lt;body&gt;</tt> element contains the code that will be
<A NAME="77540"></A> Contained by    executed. 
method    <h4><a name="77535"></a> See Also</h4>
<A NAME="77540"></A> Attributes    <tt>body</tt>, <tt>implementation</tt>, <tt>parameter</tt> 
<TT>id</TT>, <TT>name</TT>    <hr>
<H4><A NAME="77540"></A> Description</H4>    <h3><a name