Adobe Extending Dreamweaver CS4 - Manual (Page 180)

174 EXTENDING DREAMWEAVER CS4
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 Adobe 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 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
Description
Inserts a separator at the current location in the toolbar.
Attributes
{showIf}
• The showif attribute specifies that the separator should appear only on the toolbar if the given script returns true .
For example, you can use the showIf attribute to show the separator only in a given application or only when the
page has a certain document type. If the showIf attribute is unspecified, the separator always appears.
Contents
None.
Container
The
toolbar tag.
Example