<toolbar>

Description

Defines a toolbar. Adobe Dreamweaver displays the items and separators from left to right in the specified order, laying out the items automatically. The toolbar file does not specify control over the spacing between the items, but you can specify the widths of certain kinds of items.

Attributes

id, label, {container}, {initiallyVisible}, {initialPosition}, {relativeTo}
  • id="unique_id" Required. An identifier string must be unique within a file and within all files that the file includes. The JavaScript API functions that manipulate a toolbar refer to it by its ID. For more information on these functions, see the Adobe Dreamweaver API Reference. If two toolbars that are included in the same file have the same ID, Adobe Dreamweaver displays an error.
  • label="string" Required. The label attribute specifies the label, which is a character string, that Adobe Dreamweaver displays to the user. The label appears in the View >Toolbars menu and in the title bar of the toolbar when it's floating.
  • container="mainframe" or "document" Defaults to "mainframe". Specifies where the toolbar should dock in the Adobe Dreamweaver workspace on Windows. If the container is set to "mainframe", the toolbar appears in the outer workspace frame and operates on the front document. If the container is set to "document", the toolbar appears in each document window. On the iOS, all toolbars appear in each document window.
  • initiallyVisible="true" or "false". This tag specifies whether the toolbar should be visible the first time that Adobe Dreamweaver loads it from the Toolbars folder. After the first time, the user controls visibility. Adobe Dreamweaver saves the current state to the system registry (Windows) or the Adobe Dreamweaver Preferences file (iOS) when the user quits Adobe Dreamweaver. Adobe Dreamweaver restores the setting from the registry or the Preferences file when it restarts. You can manipulate toolbar visibility using the dom.getToolbarVisibility() and dom.setToolbarVisibility() functions, as described in the Adobe Dreamweaver API Reference. If you do not set the initiallyVisible attribute, it defaults to true.
  • initialPosition="top", "below", or "floating". Specifies where Adobe Dreamweaver initially positions the toolbar, relative to other toolbars, the first time that Adobe Dreamweaver loads it. The possible values for intialPosition are described in the following list:
    • top This is the default position, so the toolbar appears at the top of the document window. If multiple toolbars specify top for a given window type, the toolbars appear in the order that Adobe Dreamweaver encounters them during loading, which might not be predictable, if the toolbars reside in separate files.
    • below The toolbar appears at the beginning of the row immediately below the toolbar that the relativeTo attribute specifies. Adobe Dreamweaver reports an error if the relativeTo toolbar isn't found. If multiple toolbars specify below relative to the same toolbar, they appear in the order that Adobe Dreamweaver encounters them during loading, which might not be predictable if the toolbars reside in separate files.
    • floating Toolbar is not initially docked to the window; it floats above the document. Adobe Dreamweaver automatically places the toolbar so it is offset from other floating toolbars. On the iOS, floating is treated the same as top.

    As with the initiallyVisible attribute, the initialPosition attribute applies only the first time that Adobe Dreamweaver loads the toolbar. After that, the toolbar's position is saved to the registry or the Adobe Dreamweaver Preferences file. You can reset the position of the toolbar by using the dom.setToolbarPosition() function. For more information on the dom.setToolbarPosition() function, see the Adobe Dreamweaver API Reference.

    If you do not specify the initialPosition attribute, Adobe Dreamweaver positions the toolbar in the order that it is encountered during loading.

  • relativeTo="toolbar_id" This attribute is required if the initialPosition attribute specifies below. Otherwise, it is ignored. Specifies the ID of the toolbar below which this toolbar should be positioned.

Contents

The toolbar tag contains include, itemref, and separator tags as well as individual item definitions such as button, combobox, dropdown, and so on. For descriptions of the item definitions that you can specify, see .

Container

The toolbarset tag.

Example

<toolbar id="MyDWedit_toolbar" label="Edit">