User Guide

312 Chapter 17: Server Formats

Dreamweaver adds the function declaration by calling the applyFormat() JavaScript

function in the data format file. It changes the dynamic data object by calling the

formatDynamicDataRef() function.

The

formatDynamicDataRef() function is called when the user selects a format from the Format

text box in the Dynamic Data or the Dynamic Text dialog box or in the Bindings panel. It does

not edit the user’s document.

Arguments

dynamicDataObject

, format

• The dynamicDataObject argument is a string that contains the dynamic data object.

• The format argument is a JavaScript object that describes the format to apply. The JavaScript

object is the node that corresponds to the

format tag in the Formats.xml file. The object has a

JavaScript property for each attribute of the corresponding

format tag.

Returns

Dreamweaver expects the new value for the dynamic data object.

If an error occurs, the function displays an alert message under certain conditions. If the function

returns an empty string, the Format text box is set to

None.

inspectFormatDefinition()

Availability

Dreamweaver UltraDev 1.

Description

Initializes form controls when a user edits a format in the Edit Format List dialog box.