
The Behaviors API 313
Returns
Dreamweaver expects a string that contains the function call to be inserted in the user’s
document, usually after accepting parameters from the user. If the
applyBehavior()
function determines that the user made an invalid entry, the function can return an error
string instead of the function call. If the string is empty (
return "";), Dreamweaver does not
report an error; if the string is not empty and not a function call, Dreamweaver displays a
dialog box with the text Invalid input supplied for this behavior: [the string returned from
applyBehavior()
]. If the return value is null (return;), Dreamweaver indicates that an
error occurred but gives no specific information.
Example
The following example of the applyBehavior() function returns a call to the
MM_openBrWindow() function and passes user-specified parameters (the height and width of
the window; whether the window should have scroll bars, a toolbar, a location bar, and other
features; and the URL that should open in the window):
function applyBehavior() {
var i,theURL,theName,arrayIndex = 0;
var argArray = new Array(); //use array to produce correct ¬
number of commas w/o spaces
var checkBoxNames = new Array("toolbar","location",¬
"status","menubar","scrollbars","resizable");
for (i=0; i<checkBoxNames.length; i++) {
theCheckBox = eval("document.theForm." + checkBoxNames[i]);
if (theCheckBox.checked) argArray[arrayIndex++] = ¬
(checkBoxNames[i] + "=yes");
}
if (document.theForm.width.value)
argArray[arrayIndex++] = ("width=" + ¬
document.theForm.width.value);
if (document.theForm.height.value)
argArray[arrayIndex++] = ("height=" + ¬
document.theForm.height.value);
theURL = escape(document.theForm.URL.value);
theName = document.theForm.winName.value;
return "MM_openBrWindow('"+theURL+"',¬
'"+theName+"','"+argArray.join()+"')";
}
NOTE
Quotation marks ("")within the returned string must be preceded by a backslash (\) to
avoid errors that the JavaScript interpreter reports.
Comentarios a estos manuales