Macromedia dreamweaver 8-extending dreamweaver User Manual

The toolbar definition file

225

■

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">

<separator/>

Description

Inserts a separator at the current location in the toolbar.

Attributes

■

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

<separator/>