User Guide

176 Chapter 9: Toolbars
<itemtype/>
Description
Defines a single toolbar item. Toolbar items include buttons, radio buttons, check buttons,
combo boxes, pop-up menus, and so on. For a list of the types of toolbar items that you can
define, see “Toolbar item tags” on page 177.
Attributes
The attributes vary, depending on the item that you define. For a complete list of the attributes
that you can specify for toolbar items, see “Item tag attributes” on page 182.
Contents
None.
Container
The toolbar tag or the toolbarset tag.
Example
<button id="strikeout_button" .../>
<itemref/>
Description
Refers to (and includes in the current toolbar) a toolbar item that was defined either inside a
previous toolbar or outside of all toolbars.
Attributes
id, {showIf}
• id="id_reference" Required. Must be the ID of an item that was previously defined or
included in the file. Dreamweaver does not allow forward references. If a toolbar item tag
references an undefined ID, Dreamweaver reports an error and ignores the reference.
• showIf="script" Specifies that this item appears on the toolbar only if the specified script
returns a
true value. For example, you can use showIf to show certain buttons only in a given
application or only when a page is written in a server-side language such as ColdFusion, ASP,
or JSP. If you do not specify
showIf, the item always appears. Dreamweaver checks this
property whenever the item’s enabler runs; that is, according to the value of the
update
attribute. You should use this attribute sparingly. The
showIf attribute can be used either in
the item definition or in a reference to the item from a toolbar. If both the definition and the
reference specify the
showIf attribute, Dreamweaver shows the item only if both conditions
are true. The
showIf attribute is equivalent to the showIf() function in a command file.
Contents
None.
Container
The toolbar tag or the toolbarset tag.
Example
<itemref id="strikeout_button">