The Property inspector API functions

Two of the Property inspector API functions (canInspectSelection() and inspectSelection()) are required.

canInspectSelection()

Description

Determines whether the Property inspector is appropriate for the current selection.

Arguments

None.

 Use dom.getSelectedNode() to get the current selection as a JavaScript object (for more information about dom.getSelectedNode(), see the Dreamweaver API Reference).

Returns

Dreamweaver expects a Boolean value: true if the inspector can inspect the current selection; false otherwise.

Example

The following instance of the canInspectSelection() function returns a true value if the selection contains the CLASSID attribute, and the value of that attribute is "clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" (the class ID for Adobe Flash Player):

 function canInspectSelection(){3 
    var theDOM = dw.getDocumentDOM(); 
    var theObj = theDOM.getSelectedNode(); 
    return (theObj.nodeType == Node.ELEMENT_NODE && ¬ 
        theObj.hasAttribute("classid") && ¬ 
        theObj.getAttribute("classid").toLowerCase()== ¬ 
        "clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"); 
}

displayHelp()

Description

If this function is defined, a question mark (?) icon appears in the upper-right corner of the Property inspector. This function is called when the user clicks the icon.

Arguments

None.

Returns

Dreamweaver expects nothing.

Example

The following example of the displayHelp() function opens a file in a browser window. The file explains the fields of the Property inspector.

 function displayHelp(){ 
    dw.browseDocument(‘http://www.hooha.com/dw/inspectors/inspHelp.html’); 
}

inspectSelection()

Description

Refreshes the contents of the text fields based on the attributes of the current selection.

Arguments

maxOrMin

  • The maxOrMin argument is either max or min, depending on whether the Property inspector is in its expanded or contracted state.

Returns

Dreamweaver expects nothing.

Example

The following example of the inspectSelection() function gets the value of the content attribute and uses it to populate a form field called keywords:

 function inspectSelection(){ 
    var dom = dreamweaver.getDocumentDOM(); 
    var theObj = dom.getSelectedNode(); 
    document.forms[0].keywords.value = theObj.getAttribute("content"); 
}

Get help faster and easier

New user?