Home > Element Reference : Toolbar

Contents

### Toolbar

A container which typically contains a row of buttons. It is a type of box that defaults to horizontal orientation. It can be collapsed with a grippy when the toolbar is placed inside a toolbox. The toolbar should always have an id attribute.

More information about Toolbar

#### Attributes:

Attributes inherited from XUL Element

currentset Phoenix

The current set of displayed items on the toolbar. This should be set to a comma-separated list of item IDs from the toolbarpalette.

customindex Phoenix

This value is the index of the toolbar in the list of the custom toolbars. The value is updated automatically by the toolbar customization dialog.

customizable Phoenix

Set this attribute to true on toolbars that can be customized. This causes the set of buttons to be persisted across sessions.

defaultset Phoenix

The default set of displayed items on the toolbar. This should be set to a comma-separated list of item IDs from the toolbarpalette. For example, 'back-button,forward-button,print-button'.

grippyhidden

When set to true, the grippy will be hidden. When set to false, the default, the grippy will be shown.

iconsize Phoenix

The size of the icons on the toolbar buttons. Use the value 'small' for small icons or leave out for large icons. This value is inherited from the toolbox in customizable toolbars.

mode Phoenix

The button display mode on the toolbar, which indicates whether text, icons or both are displayed. This value is inherited from the toolbox in customizable toolbars.

- icons: Only icons are displayed.
- text: Only labels are displayed.
- full: Both icons and labels are displayed.

toolbarname Phoenix

The name of the toolbar, which is listed in the Show/Hide toolbars menu.

#### Properties and Methods:

Properties and Methods inherited from XUL Element

insertItem ( id , beforeNode , wrapper ) Phoenix

Add an item with the given id to the toolbar. The new item is added just before the item given by the second argument. If the second argument is null, the item is added to the end of the toolbar. The third argument can be used to wrap the new item in another element. Usually, the last argument will be null as it is mainly for the use of the customize dialog.

The IDs come from the palette associated with the toolbox. Some special IDs can be used also:

- separator: A separator, which is drawn as a vertical bar
- spacer: A non-flexible space.
- spring: A flexible space.

toolbarName Phoenix

The name of the toolbar.

Copyright (C) 1999 - 2002 XULPlanet.com