MDN may have intermittent access issues April 18 13:00 - April 19 01:00 UTC. See whistlepig.mozilla.org for all notifications.

mozilla
Your Search Results

    toolbox

    A container for toolbars. It is a type of box but defaults to vertical orientation. If a toolbar is placed inside a toolbox, a grippy is displayed on its left or upper edge. The user may click the grippy to collapse the toolbar. If multiple toolbars are placed in the same toolbox, they will all collapse into the same row. The Firefox browser does not have grippies so toolbars cannot be collapsed and expanded.

    Note: Gecko 2.0 adds support for external toolbars. These are toolbars that are not children of a toolbox. You can associate an external toolbar with a toolbox for the purpose of managing your toolbars by setting the toolboxid property on the toolbar. The external toolbars associated with a toolbox are listed in the array of elements provided by the toolbox's externalToolbars property.

    More information is available in the XUL tutorial.

    If you'd like to detect when toolbars in a toolbox are changed, see Toolbar customization events.

    Properties
    accessible, customToolbarCount, externalToolbars, palette, toolbarset
    Methods
    appendCustomToolbar, collapseToolbar, expandToolbar

    Examples

    toolbox.png

    <?xml version="1.0"?>
    <?xml-stylesheet href="chrome://global/skin/" type="text/css"?>
    <window id="yourwindow" xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul" title="toolbox example" width="300">
      <toolbox>
        <toolbar>
          <toolbarbutton label="Back"/>
          <toolbarbutton label="Forward"/>
          <toolbarbutton label="Home"/>
        </toolbar>
        <toolbar>
          <toolbarbutton label="Stop"/>
          <toolbarbutton label="Reload"/>
        </toolbar>
      </toolbox>
      <textbox multiline="true" value="We have two toolbars inside of one toolbox above." width="20"/>
    </window>
    

    Attributes

    Inherited from XUL element
    align, allowevents, allownegativeassertions, class, coalesceduplicatearcs, collapsed, container, containment, context, contextmenu, datasources, dir, empty, equalsize, flags, flex, height, hidden, id, insertafter, insertbefore, left, maxheight, maxwidth, menu, minheight, minwidth, mousethrough, observes, ordinal, orient, pack, persist, popup, position, preference-editable, querytype, ref, removeelement, sortDirection, sortResource, sortResource2, statustext, style, template, tooltip, tooltiptext, top, uri, wait-cursor, width

    Properties

    accessible
    Type: nsIAccessible
    Returns the accessibility object for the element.
    customToolbarCount
    Firefox only
    Type: integer
    The number of custom toolbars currently within the toolbox.
    externalToolbars
    Type: array of elements
    An array of external toolbars; that is, toolbar elements that should be considered to be members of this toolbox, even if they are not actually children of the toolbox.
    palette
    Firefox only
    Type: element
    The toolbarpalette within the toolbox.
    toolbarset
    Firefox only
    Type: element
    The toolbarset within the toolbox.

    Methods

    Inherited Methods
    addEventListener(), appendChild(), blur, click, cloneNode(), compareDocumentPosition, dispatchEvent(), doCommand, focus, getAttribute(), getAttributeNode(), getAttributeNodeNS(), getAttributeNS(), getBoundingClientRect(), getClientRects(), getElementsByAttribute, getElementsByAttributeNS, getElementsByClassName(), getElementsByTagName(), getElementsByTagNameNS(), getFeature(), getUserData, hasAttribute(), hasAttributeNS(), hasAttributes(), hasChildNodes(), insertBefore(), isDefaultNamespace(), isEqualNode, isSameNode, isSupported(), lookupNamespaceURI, lookupPrefix, normalize(), querySelector(), querySelectorAll(), removeAttribute(), removeAttributeNode(), removeAttributeNS(), removeChild(), removeEventListener(), replaceChild(), setAttribute(), setAttributeNode(), setAttributeNodeNS(), setAttributeNS(), setUserData

    appendCustomToolbar( name, currentset )
    Firefox only
    Return type: element
    Adds a custom toolbar to the toolbox with the given <var>name</var>. You can supply a comma-separated list of toolbar item ids as the second argument to add some items by default. The method returns the DOM element for the created toolbar.
    collapseToolbar( toolbar )
    Not in Firefox
    Return type: no return value
    Collapse the given <var>toolbar</var> which should be contained within the toolbox.
    expandToolbar( toolbar )
    Not in Firefox
    Return type: no return value
    Expand the given <var>toolbar</var> which should be contained in the toolbox.

    Elements
    toolbar, toolbarbutton, toolbargrippy, toolbaritem, toolbarpalette, toolbarseparator, toolbarset, toolbarspacer, toolbarspring
    Interfaces
    nsIAccessibleProvider

    Document Tags and Contributors

    Contributors to this page: Sheppy, kscarfone, Gryllida, q0k, trevorh, Ptak82, Mgjbot, Pmash, Dria
    Last updated by: Sheppy,