Specifications

The Dreamweaver JavaScript API 383
Example
If you write an action that can be applied only to a hypertext link (A HREF), you can use
getBehaviorTag() as part of the function that initializes the user interface for the Parameters
dialog box.
function initializeUI(){
var theTag = dreamweaver.getBehaviorTag().toUpperCase();
var CANBEAPPLIED = (theTag.indexOf(’HREF’) != -1));
if (CANBEAPPLIED) {
// display the action UI
} else{
// display a helpful message that tells the user
// that this action can only be applied to a
// hyperlink
}
}
dreamweaver.popupAction()
Availability
Dreamweaver 2
Description
Presents the user with a Parameters dialog box for the specified behavior action. To the user, the
effect is the same as selecting the action from the Actions pop-up menu in the Behaviors panel.
This function lets extension files other than actions attach behaviors to objects in the user’s
document. It blocks other edits until the user dismisses the dialog box.
Note: This function can be called only within objectTag() or in any script in a command or the Property
inspector file.
Arguments
actionName, {funcCall}
• actionName is the name of a file in the Configuration/Behaviors/Actions folder that contains a
JavaScript behavior action; for example,
"Timeline/Play Timeline.htm".
• funcCall is a string that contains a function call for the action specified in actionName; for
example,
"MM_playTimeline(...)". This argument, if specified, is supplied by the
applyBehavior() function in the action file.
Returns
The function call for the behavior action. When the user clicks OK in the Parameters dialog box,
the behavior is added to the current document (the appropriate functions are added to the
HEAD
of the document, HTML might be added to the top of the
BODY, and other edits might be made
to the document). The function call (for example,
"MM_playTimeline(...)") is not added to
document but becomes the return value of this function.