User Guide

174 Chapter 9: Toolbars
<toolbar>
Description
Defines a toolbar. 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 Dreamweaver API Reference. If two
toolbars that are included in the same file have the same ID, Dreamweaver displays an error.
• label="string" Required. The label attribute specifies the label, which is a character string,
that 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 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 Macintosh, all toolbars appear in each document window.
• initiallyVisible="true" or "false". This tag specifies whether the toolbar should be
visible the first time that Dreamweaver loads it from the Toolbars folder. After the first time,
the user controls visibility. Dreamweaver saves the current state to the system registry
(Windows) or the Dreamweaver Preferences file (Macintosh) when the user quits
Dreamweaver. 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 Dreamweaver API Reference. If
you do not set the
initiallyVisible attribute, it defaults to true.
• initialPosition="top", "below", or "floating". Specifies where Dreamweaver initially
positions the toolbar, relative to other toolbars, the first time that 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 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. 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 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.
Dreamweaver automatically places the toolbar so it is offset from other floating toolbars. On
the Macintosh,
floating is treated the same as top.