Adobe Extending Dreamweaver CS4 - Manual (Page 219)

213 EXTENDING DREAMWEAVER CS4
Tag libraries and editors
Returns
Dreamweaver expects a Boolean value:
true if the input for HTML form elements is valid; false if input values are
not valid.
Example
When the user creates a table, a negative integer is entered for the number of table rows. The
validateTag() function
detects the invalid input, displays an alert message, and returns a false value.
applyTag()
Availability
Dreamweaver MX.
Description
When the user clicks OK, Dreamweaver calls the
validateTag() function. If the validateTag() function returns a
true value, Dreamweaver calls this function and passes the dom object that represents the current tag (the tag that is
being edited). The function reads the values out of the form elements and writes them into the dom object.
Arguments
tag
• The tag argument is the DOM node of the tag being edited.
Returns
Dreamweaver expects nothing.
Example
Continuing the
cfweather example, in the following code, if the user changes the ZIP code from 94065 to 53402, in
order to update the user’s document to use the new ZIP code, the dom object must be updated:
function applyTag(tag)
{
tag.zip = document.forms[0].zip.value
}