Exit Safeguard (deprecated)
The Exit Safeguard view is used as a confirmation message that is activated when the user closes a browser window or tab. This view can be used to prompt the user that they are about the close a window or tab. Note: To combat unwanted pop-ups, some browsers may not display prompts created in beforeunload event handlers unless the page has been interacted with; this is currently true for FireFox. If a user never interacts with a page, the browser does not display the confirmation message.
null
| Challenge on exit by default: | When true a challenge is presented to the user if they attempt to close the browser window | Boolean |
| Exit challenge message: | Additional message to display when challenging an exit. All browsers display a challenge, but some will not show this additional message. | String |
Extends:
Methods:
Inherited
addClass(name, [replaced])
Add or replace the CSS classes for this view.
| Name | Type | Default | Description |
| name | {string} | The CSS class names to add to the view. For multiple classes, use space to separate the class names. | |
| replaced | {string} | The CSS class names to be replaced by the first argument. For multiple classes, use space to separate the class names. |
Example
| Button.addClass("green"); |
getChallengeMessage()
Returns:
{string}
Gets the message that will be displayed when challenging an exit
getType()
Returns:
{string}
Get descriptive string representing the type of control/section
Inherited
isBound()
Returns:
{boolean}
Indicate the bound status of the view.
Inherited
isEnabled()
Returns:
{boolean}
Check whether the view is enabled.
Example
| var enabled = MyView.isEnabled(); |
isExitChallenged()
Returns:
{boolean}
Return whether or not exit is challenged by default
Inherited
propagateUpValueChange(event)
Returns:
{boolean}
Propagate the value change of the view up through the parent views.
| Name | Type | Default | Description |
| event | {Event} | Value change event (usually an onchange event) |
Example
| MyView.propagateUp(event); |
setChallengeMessage(msg)
Sets the message that will be displayed when challenging an exit
| Name | Type | Default | Description |
| msg | {string} | Message to be displayed |
setExitChallenged(flag)
Set whether or not an exit is challenged by default
| Name | Type | Default | Description |
| flag | {boolean} | Set to true to challenge exit by default |
Inherited
setViewData(data, createPseudoBinding)
Set or update the bound data associated with the view. It applies only to views with bound data.
Note: It should only be used with simple type bindings, or complex type bindings with simple type properties.
It should not be used with bindings that have properties that are lists or compext types. For complex types, set the bindings by using
the
Note: It should only be used with simple type bindings, or complex type bindings with simple type properties.
It should not be used with bindings that have properties that are lists or compext types. For complex types, set the bindings by using
the
binding.set pattern, as described in the Binding data and configuration options documentation section.| Name | Type | Default | Description |
| data | {Object} | The value of the bound data. The parameter type must match the type of the bound data. | |
| createPseudoBinding | {boolean} | If the value is set to true, the parameter creates a pseudo binding if there is no current binding. |
Example
| MyView.setViewData("TEST"); //Updates bound data to the string 'TEST' |
Inherited
triggerFormulaUpdates([phase])
Broadcast the expression trigger for the specified view.
| Name | Type | Default | Description |
| phase | {int} | bpmext.ui.PHASE_NORMAL | The phase we are currently in |
Example
| MyView.triggerFormulaUpdates(); |