Property inspector files

 < Day Day Up > 

The Property inspector HTML file must contain a comment (in addition to the doctype comment) immediately preceding the opening HTML tag, as shown in the following example:

<!-- tag:serverModel:tagNameOrKeyword,priority:1to10,selection: exactOrWithin,hline,vline, serverModel--> <!DOCTYPE HTML SYSTEM "-//Macromedia//DWExtension layout-engine5.0//pi">

This comment has the following elements:

  • The serverModel element specifies that Dreamweaver should load this Property inspector only when the server model specified is active.

  • The tagNameOrKeyword element is the tag to be inspected or one of the following keywords: *COMMENT* (for comments), *LOCKED* (for locked regions), or *ASP* (for ASP tags).

  • The 1to10 element is the priority of the Property inspector file: 1 indicates that this inspector should be used only when no others can inspect the selection; 10 indicates that this inspector takes precedence over all others that can inspect the selection.

  • The exactOrWithin element indicates whether the selection can be within the tag (within) or must exactly contain the tag (exact).

  • The hline element (optional) indicates that a horizontal gray line should appear between the upper and lower halves of the inspector in expanded mode.

  • The vline element (optional) indicates that a vertical gray line should appear between the tag name field and the rest of the properties in the inspector.

  • The serverModel element (optional) indicates the server model of the Property inspector. If the server model of the Property inspector is not the same as the server model for the document, Dreamweaver does not use the Property inspector to display the properties of the current selection. For example, if the server model of the document is Macromedia ColdFusion, but the server model of the Property inspector is ASP, Dreamweaver does not use that Property inspector for selections in the document.

The following comment is appropriate for an inspector that is designed to inspect the HAPPY tag:

 <!-- tag:HAPPY, priority:8,selection:exact,hline,vline, serverModel:ASP --> 

In some cases, you might want to specify that your extension use only Dreamweaver extension rendering (and not the previous rendering engine) by inserting the following line immediately before the tag comment, as shown in the following example:

 <!--DOCTYPE HTML SYSTEM "-//Macromedia//DWExtension layout-engine 5.0//pi"--> 

The BODY section of a Property inspector file contains an HTML form. Instead of displaying the form contents in a dialog box, however, Dreamweaver uses the form to define the input areas and layout of the Property inspector.

The HEAD section of a Property inspector file contains JavaScript functions or a reference to the JavaScript file or files.

     < Day Day Up > 


    Developing Extensions for Macromedia Dreamweaver 8
    Developing Extensions for Macromedia Dreamweaver 8
    ISBN: 0321395409
    EAN: 2147483647
    Year: 2005
    Pages: 282

    flylib.com © 2008-2017.
    If you may any questions please contact us: flylib@qtcs.net