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
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 (
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
]. If the return value is
applyBehavior()
error occurred but gives no specific information.
Quotation marks ("")within the returned string must be preceded by a backslash (\) to
avoid errors that the JavaScript interpreter reports.
Example
The following example of the
MM_openBrWindow()
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()+"')";
}
null
applyBehavior()
function and passes user-specified parameters (the height and width of
applyBehavior()
return "";
(
), Dreamweaver indicates that an
return;
function returns a call to the
), Dreamweaver does not
The Behaviors API
313
Need help?
Do you have a question about the DREAMWEAVER 8-EXTENDING DREAMWEAVER and is the answer not in the manual?