Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

launchLocalAction: Public JS API for Actions

Updated on April 6, 2017

launchLocalAction

Launch a local action either as a modal dialog, overlay or by replace the current section.

Syntax

var options = {
flowAction: “flowActionName ",
displayMode: pega.api.ui.constants.REPLACE_CURRENT / pega.api.ui.constants.OVERLAY / pega.api.ui.constants.MODAL_DIALOG",
event: eventObject,
flowActionClass: "className" ,
contextPage: "pageName",
skinFormat: "skinFormat",
template: "templateName",
isMobileFullScreen: true/false,
revealEffectName: "animtionName",
closingEffectName: "animtionName",
closeOnClickAway: true/ false,
centerOverlay: true/false
};

pega.api.ui.actions.launchLocalAction(options);

Parameters

This API accepts a JavaScript object which can have the following key-values.

  • flowAction: Flow action name
  • displayMode: Optional. The following are valid values:
    • pega.api.ui.constants.REPLACE_CURRENT
    • pega.api.ui.constants.OVERLAY
    • pega.api.ui.constants.MODAL_DIALOG
    • pega.api.ui.constants.REPLACE_CURRENT option is supported only when you are performing the assignment in case. The default value is pega.api.ui.constants.REPLACE_CURRENT.
  • event: The event refers to a DOM eventObject.
  • flowActionClass: Flow Action class
  • contextPage: Optional. This string specifies the name of the context page to render flow action.
  • skinFormat: Optional. This string specifies the skin format name. The default value is Standard. This is respected only when the displayMode is Overlay / Modal Dialog
  • template: Optional. Applicable when displayMode is Modal Dialog. Use this to specify the modal dialog template. The default value is pzModalTemplate. This is required only when the displayMode is Modal Dialog.
  • closeOnClickAway: Optional. Applicable when the displayMode is Overlay. Use a Boolean value to specify if the overlay should be dismissed when the user clicks outside the overlay. The default value is true.
  • centerOverlay: Optional. Applicable when the displayMode is Overlay. Use a Boolean to indicate if the overlay should be positioned in the center of the screen rather than relative to the event target. The default value is false.
  • isMobileFullScreen: Optional. Display full screen or not on mobile. The default value is true.
  • revealEffectName: Optional. This is applicable only when isMobileFullScreen is true. Indicates the name of the animation to be applied when displaying the modal dialog or overlay. Valid values are:
    • From Bottom
    • Fade in
    • Grow
    • From left
    • From right
    • Shrink
    • From top
    • Vertical flip
  • closingEffectName: Optional. Only applicable when isMobileFullScreen is true. Name of the animation to be applied when dismissing the modal dialog or overlay. Valid values are:
    • Reverse the reveal effect
    • To top
    • To bottom
    • To left
    • To right
    • Shrink
    • Grow
    • Vertical flip
    • Fade out

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us