The Configuration/Objects/insertbar.xml file defines the Insert bar properties. This XML file contains definitions for each individual object, in the order in which the objects appear.
The first time a user starts Dreamweaver, the Insert bar appears horizontally above the document. After that, its visibility and position are saved in the registry.
<?xml version="1.0" ?> <!DOCTYPE insertbarset SYSTEM "-//Adobe//DWExtension insertbar 10.0"> <insertbar xmlns:MMString="http://www.adobe.com/schemes/data/string/"> <category id="DW_Insertbar_Common" MMString:name="insertbar/categorycommon" folder="Common"> <button id="DW_Hyperlink" image="Common\Hyperlink.png" MMString:name="insertbar/hyperlink" file="Common\Hyperlink.htm" /> <button id="DW_Email" image="Common\E-Mail Link.png" MMString:name="insertbar/email" file="Common\E-Mail Link.htm" /> <separator /> <menubutton id="DW_Images" MMString:name="insertbar/images" image="Common\Image.png"> <button id="DW_Image" image="Common\Image.png" MMString:name="insertbar/image" file="Common\Image.htm" /> ... </menubutton> <separator /> <button id="DW_TagChooser" MMString:name="insertbar/tagChooser" image="Common\Tag Chooser.gif" command="dw.showTagChooser()" codeOnly="TRUE"/> </category> ... </insertbar>
Note:
The insertbar and category tags use </insertbar> and </category> closing tags to denote the end of their content. The tags button, checkbutton, and separator use a slash (/) before the closing bracket to denote the end of their attributes and content.
This tag signals the content of the Insert bar definition file. The </insertbar> closing tag specifies the end of the content.
<insertbar> <category id="DW_Insertbar_Common" folder="Common"> <button id="DW_Hyperlink" image="Common\Hyperlink.gif" file="Common\Hyperlink.htm"/>0 ... </insertbar>
This tag defines a category on the Insert bar (such as Common, Forms, or HTML). The </category> closing tag specifies the end of the category content.
Note:
By default, the Insert bar is organized into categories of use (such as Common, Forms, or HTML). In previous versions of Dreamweaver, the Insert bar was organized similarly by tabs. Users can set their own preferences for how the Insert bar objects are organized (by category or tab). If the user has selected the tab organization, the category tag defines each tab.
<category id="DW_Insertbar_Common" folder="Common"> <button id="DW_Hyperlink" image="Common\Hyperlink.gif" file="Common\Hyperlink.htm"/> </category>
<menubutton id="DW_ImageMenu" name="Images" image="Common\imagemenu.gif" folder="Images"> <button id="DW_Image" image="Common\Image.gif" enabled="" showIf="" file="Common\Image.htm" /> </menubutton>
This tag defines a button on the Insert bar that the user clicks to execute the code that the command or file attributes specify.
<button id="DW_Object" image="Common\Object.gif" name=”Object” enabled="true" showIf="" file="Common\Obect.htm" />
A checkbutton is a button that has a checked or unchecked state. When clicked, a checkbutton appears pressed in and highlighted. When it is unchecked, a checkbutton appears flat. Dreamweaver has Mouse-over, Pressed, Mouse-over-while-pressed, and Disabled-while-pressed states. The command must ensure that clicking the checkbutton causes its state to change.
<checkbutton id="DW_StandardView" name = "Standard View" image="Tools\Standard View.gif" checked="_View_Standard" command="dw.getDocumentDOM().setShowLayoutView(false)"/>
<separator showIf="_VIEW_CODE"/>
The id attribute is an identifier for the buttons that appear on the Insert bar. The id attribute must be unique for the element within the file.
id="DW_Anchor"
This attribute specifies the path, relative to the Dreamweaver Configuration folder, to the icon file that appears on the Insert bar. The icon can be in any format that Dreamweaver can render, but typically it is in GIF or JPEG file format, with a size of 18 x 18 pixels.
image="Common/table.gif"
This attribute specifies whether the user can drag the icon into the code or workspace to insert the object into a document. If omitted, the default value is true.
canDrag="false"
This attribute specifies that this button should appear on the Insert bar only if the given Dreamweaver enabler is a true value. If you do not specify showIf, the button always appears. The possible enablers are _SERVERMODEL_ASP, _SERVERMODEL_ASPNET, _SERVERMODEL_JSP, _SERVERMODEL_CFML (for all versions of Adobe ColdFusion), _SERVERMODEL_CFML_UD4 (only for UltraDev version 4 of Adobe ColdFusion), _SERVERMODEL_PHP, _FILE_TEMPLATE, _VIEW_CODE, _VIEW_DESIGN, _VIEW_LAYOUT, _VIEW_EXPANDED_TABLES, and _VIEW_STANDARD.
To specify multiple enablers, place a comma (which means AND) between the enablers. To specify NOT, use an exclamation point (!).
showIf="_VIEW_CODE, _SERVERMODEL_ASP"
This attribute specifies that the item is available to the user if the DW_enabler value is true. If you do not specify the enabled function, the item defaults to always enabled. The possible enablers are _SERVERMODEL_ASP, _SERVERMODEL_ASPNET, _SERVERMODEL_JSP, _SERVERMODEL_CFML (for all versions of ColdFusion), _SERVERMODEL_CFML_UD4 (only for UltraDev version 4 of ColdFusion), _SERVERMODEL_PHP, _FILE_TEMPLATE, _VIEW_CODE, _VIEW_DESIGN, _VIEW_LAYOUT, _VIEW_EXPANDED_TABLES, and _VIEW_STANDARD.
To specify multiple enablers, place a comma (which means AND) between the enablers. To specify NOT, use an exclamation point (!).
enabled="_VIEW_CODE"
The checked attribute is required if you use the checkbutton tag.
The item is checked if the DW_enabler value is true. The possible enablers are _SERVERMODEL_ASP, _SERVERMODEL_ASPNET, _SERVERMODEL_JSP, _SERVERMODEL_CFML (for all versions of ColdFusion), _SERVERMODEL_CFML_UD4 (only for UltraDev version 4 of ColdFusion), _SERVERMODEL_PHP, _FILE_TEMPLATE, _VIEW_CODE, _VIEW_DESIGN, _VIEW_LAYOUT, _VIEW_EXPANDED_TABLES, and _VIEW_STANDARD.
To specify multiple enablers, place a comma (which means AND) between them. To specify NOT, use an exclamation point (!).
checked="_View_Layout"
Instead of referring Dreamweaver to an HTML file that contains the code to insert, you use this tag to specify a command that Dreamweaver performs when the button is clicked.
command="dw.showTagChooser()"
The file attribute specifies the path, relative to the Dreamweaver Configuration folder, of an object file. Dreamweaver derives the tooltip for the object icon from the title of the object file, unless you specify the name attribute.
file="Templates/Editable.htm"
This attribute tells Dreamweaver to invoke a Tag editor. In Code view, if the tag attribute is defined and the user clicks the object, Dreamweaver invokes the Tag dialog box. In Code view, if you specify the tag and command attributes, Dreamweaver invokes the Tag editor. In Design view, if codeOnly="TRUE" and you do not specify the file attribute, Dreamweaver invokes Code and Design view, places focus in the code, and invokes the Tag editor.
tag = "form"
The name attribute specifies the tooltip that appears when the mouse pointer rests over the object. If you specify an object file but do not specify the name attribute, Dreamweaver uses the name of the object file for the tooltip.
Note:
If the name attribute is not provided, the object will not be available for grouping in the Favorites category on the Insert bar UI.
Some Insert bar objects use a variation of the name attribute with prefix MMString. The MMString denotes a localized string; these values are explained in Localizing an extension.
name = "cfoutput"