Adobe Extending Dreamweaver CS4 - Manual (Page 218)

212 EXTENDING DREAMWEAVER CS4
Tag libraries and editors
The tag editor API functions
In order to create a new tag editor, you must provide an implementation for the inspectTag() , validateTag() , and
applyTag() functions. For an example of an implementation, see “ Create a tag editor UI ” on page 209.
inspectTag()
Availability
Dreamweaver MX.
Description
The function is called when the tag editor first appears. The function receives as an argument the tag that the user is
editing, which is expressed as a
dom object. The function extracts attribute values from the tag that is being edited and
uses these values to initialize form elements in the tag editor.
Arguments
tag
• The tag argument is the DOM node of the edited tag.
Returns
Dreamweaver expects nothing.
Example
Suppose the user edits the following tag:
If the editor contains a text field for editing the zip attribute, the function needs to initialize the form element so that
the user sees the actual ZIP code in the text field, rather than an empty field.
The following code performs the initialization:
function inspectTag(tag)
{
document.forms[0].zip.value = tag.zip
}
validateTag()
Availability
Dreamweaver MX.
Description
When a user clicks on a node in the tree control or clicks OK, the function performs input validation on the currently
displayed HTML form elements.
Arguments
None.