Class: PopupMenu

PopupMenu

A Popup Menu control allows you to create a popup menu on other controls. It must be opened programmatically (usually through other controls). A PopupMenu control provides the following configuration properties in Process Designer:

Appearance
Show Label: Show the control's label boolean
Label Placement: Set the location of the label relative to the rest of the control. Note: has no effect if label is not being shown
{Top | Left}		 string
Horizontal Alignment: Whether menu should be aligned to the left or right of the control contained within this
{Left | Right}		 string
Vertical Position: Sets if menu will appear above or below the control inside of it
{Bottom | Top}		 string
Drop Shadow: Give the menu a shadow boolean
Width: Width of "envelope" wrapping the contained view/element string

Behavior
Make Sticky: Prevents menu from auto-closing when a menu item is clicked or when the menu is no longer in focus boolean

Menu Items: Items in the menu MenuItemSpec[]
Command Command to execute when this menu item is selected string
Item type Type of menu item this is (affects how item is displayed)
{Label | Separator | Section Header}		 string
Icon Icon to add to this item (leave blank for no icon) string
Item text Text to display for this item (no text is displayed for separators) string
Badge shape Badge shape to use (if any)
{None | Square | Rounded}		 string
Badge color Badge color style
{Default | Primary | Info | Success | Warning | Danger}		 string
Badge text Text to add to badge string

Events
On Load:
Description: Triggers whenever the view is loaded.
Example: 
me.setMenuVisible(true)
On Item Click:
Description: Triggers when an item is clicked.
Example: 
${Text1}.setLabelPosition(command) //sets the label position of the Text1 control to the value of command
//the value of command is set in the menu item command property
Context Variables command {string}
Articles
Popup Menu

new PopupMenu()

PopupMenu.js, line 7
This constructor is never used explicitly.

Extends

Members

uibpmext.ui.View

Methods

inherited addClass(name, replaced)

BPMExt-Core/com/salientprocess/bpm/views/bpmext.js, line 2466
Add/replace CSS class(es) for this control
Name Type Description
name string CSS class name(s) to add to the control. Separate class names by a space if more than one class.
replaced string optional CSS class name(s) to be replaced by the first argument. Separate class names by a space if more than one class.
Example
Button.addClass("green");

addMenuItem(item)

PopupMenu.js, line 296
Add menu item to end of item list
JSON Structure of menu items
{
     command : string
     itemType : "L"=Label | "S"=Seperator | "H"=Section Header
     icon : string
     iconText : string
     badgeShape : "N"=None | "S"=Square | "R"=Rounded
     badgeColor : "D"=Default | "P"=Primary | "I"=Info | "S"=Success | "W"=Warning | "G"=Danger
     badgeText : string
}
Name Type Description
item MenuItem Item to set in control (see method description for object structure)

inherited getData(){Object}

BPMExt-Core/com/salientprocess/bpm/views/bpmext.js, line 2101
Retrieve bound data associated this view/control. Only works for views/controls with bound data.
Returns:
Type Description
Object Value of bound data. undefined if the view has no data binding.
Example
var dec1 = MyDecimal.getData();

getLabel(){string}

PopupMenu.js, line 170
Get label associated with control
Returns:
Type Description
string

getLabelPlacement(){string}

PopupMenu.js, line 186
Get label placement for control
Returns:
Type Description
string {"T"=Top | "L"=Left}

getMenuItem(index){MenuItem}

PopupMenu.js, line 235
Get menu item at specified index.
Name Type Description
index any when numeric this is the Index of menu item to get, when a string it is the Command associated with the menu item to be returned
Returns:
Type Description
MenuItem or null if not located
JSON Structure of menu items
{
     command : string
     itemType : "L"=Label | "S"=Seperator | "H"=Section Header
     icon : string
     iconText : string
     badgeShape : "N"=None | "S"=Square | "R"=Rounded
     badgeColor : "D"=Default | "P"=Primary | "I"=Info | "S"=Success | "W"=Warning | "G"=Danger
     badgeText : string
}

getMenuItemCount(){integer}

PopupMenu.js, line 288
Get number of items in menu
Returns:
Type Description
integer

getMenuItemIndex(when)

PopupMenu.js, line 279
Get the index of the specified menu item or -1 if the menuItem cannot be located.
Name Type Description
when any a string it is the Command associated with the menu item whose index is to be returned, when an object it is the menuitem whose index is to be returned
Returns:
index

getMenuItems(){Array.<MenuItem>}

PopupMenu.js, line 258
Returns:
Type Description
Array.<MenuItem>
JSON Structure of menu items
{
     command : string
     itemType : "L"=Label | "S"=Seperator | "H"=Section Header
     icon : string
     iconText : string
     badgeShape : "N"=None | "S"=Square | "R"=Rounded
     badgeColor : "D"=Default | "P"=Primary | "I"=Info | "S"=Success | "W"=Warning | "G"=Danger
     badgeText : string
}

getType(){string}

PopupMenu.js, line 344
Get descriptive string representing the type of control
Returns:
Type Description
string

inherited hide(collapseFlag)

BPMExt-Core/com/salientprocess/bpm/views/bpmext.js, line 1861
Hide this view/control
Name Type Description
collapseFlag boolean Set to true to collapse the view (equivalent to a view setting of "NONE")
Example
MyView.hide();

inherited isBound(){boolean}

BPMExt-Core/com/salientprocess/bpm/views/bpmext.js, line 2088
Indicates bound status of control.
Returns:
Type Description
boolean True if the control is bound to coach data.

inherited isEnabled(){boolean}

BPMExt-Core/com/salientprocess/bpm/views/bpmext.js, line 2034
Checks if the view is enabled or not
Returns:
Type Description
boolean Enabled status
Example
var enabled = MyView.isEnabled();

inherited isLabelVisible(){boolean}

BPMExt-Core/com/salientprocess/bpm/views/bpmext.js, line 1835
Checks if control label is visible
Returns:
Type Description
boolean Label visibility status
Example
var labelVisible = MyView.isLabelVisible();

isMenuVisible(){boolean}

PopupMenu.js, line 202
Get the visibility of the menu
Returns:
Type Description
boolean

inherited isValid(){boolean}

BPMExt-Core/com/salientprocess/bpm/views/bpmext.js, line 2370
Returns the valid status as last set by the setValid() method.
Returns:
Type Description
boolean Validity status. true if setValid(false, ...) was never called
Example
var valid = MyView.isValid();

inherited isVisible(){boolean}

BPMExt-Core/com/salientprocess/bpm/views/bpmext.js, line 1943
Checks whether or not view is visible
Returns:
Type Description
boolean Visibility status
Example
var visible = MyView.isVisible();

inherited propagateUpValueChange(event){boolean}

BPMExt-Core/com/salientprocess/bpm/views/bpmext.js, line 2403
Propagates value change of control up through parent views
Name Type Description
event Event Value change event (usually an onchange event)
Returns:
Type Description
boolean True if a formula update was triggered on the control's parent, otherwise false
Example
MyView.propagateUp(event);

inherited recalculate()

BPMExt-Core/com/salientprocess/bpm/views/bpmext.js, line 2732
Only for formula-enabled views!
Explicitly triggers the re-evaluation of the formula for this view (if a formula has been specified). If the view is not formula-enabled, recalculate() does nothing.
Example
Text1.recalculate(); //If the formula for Text1 is: new Date().toString(), Text1 is updated to the current date/time

removeMenuItem(index)

PopupMenu.js, line 318
Get label placement for control
Name Type Description
index integer Index of item to remove

inherited setData(value)

BPMExt-Core/com/salientprocess/bpm/views/bpmext.js, line 2070
Set/update bound data associated this view/control. Only works for views/controls with bound data.
Name Type Description
value Object Value of bound data. The type of this parameter must match the type of the bound data.
Example
MyView.setData("TEST"); //Updates bound data to the string 'TEST'

inherited setEnabled(enabled, required)

BPMExt-Core/com/salientprocess/bpm/views/bpmext.js, line 1959
Enable/disable this view/control
Name Type Description
enabled boolean Enabled/read-only flag (true to enable view, false to disable/make read-only)
required boolean Enable/disable required field flag for control
Example
MyView.setEnabled(false); //Make MyView read-only

setHorizontalAlignment(alignment)

PopupMenu.js, line 210
Set the horizontal alignment of the menu. NOTE: to avoid ambiguity always set the size style using "L"|"R"
Name Type Description
alignment string "LEFT"|"L"=Left | "RIGHT"|"R"=Right

setLabel(label)

PopupMenu.js, line 162
Set label for control
Name Type Description
label string Label to set

setLabelPlacement(placement)

PopupMenu.js, line 178
Set label placement for control
Name Type Description
placement string "T","TOP"=Top | "L","LEFT"=Left

inherited setLabelVisible(visible)

BPMExt-Core/com/salientprocess/bpm/views/bpmext.js, line 1874
Show/hide the label of this view/control
Name Type Description
visible boolean Label visibility flag (true to show view label, false to hide)
Example
MyView.setLabelVisible(false);

setMenuItem(item, index)

PopupMenu.js, line 226
Set menu item at specified index. If index is greater than the current max index, item will be added to the menu at the next index location. Otherwise the item at the specified index will be overwritten.
Name Type Description
item MenuItem Item to set in control
index integer Index at which to set menu item

setMenuItemBadgeText(text, index)

PopupMenu.js, line 326
Set badge text for an item
Name Type Description
text string Badge text to set
index integer Index of item badge text is being set for

setMenuItemIcon(icon, index)

PopupMenu.js, line 335
Set badge text for an item
Name Type Description
icon string visit http://fontawesome.io/icons/ for icon options
index integer Index of item icon is being set for

setMenuVisible(vis)

PopupMenu.js, line 194
Set menu visibility. This is the only way to change the visibility of the menu. It will not pop up just by clicking on controls inside of it
Name Type Description
vis boolean Set to true to make the menu visible

inherited setValid(valid, errorText)

BPMExt-Core/com/salientprocess/bpm/views/bpmext.js, line 2342
Flag this view/control as valid or invalid
Name Type Description
valid boolean Valid/invalid flag (true to set view valid, false to make it invalid - which typically shows the view with "invalid" styling and indicator)
errorText string Validation error text to show on the invalid-styled view
Example
MyView.setValid(false, "Please fix your data entry"); //Make MyView invalid

setVerticalAlignment(alignment)

PopupMenu.js, line 218
Set the vertical alignment of the menu. NOTE: to avoid ambiguity always set the size style using "T"|"B"
Name Type Description
alignment string "TOP"|"T"=Top | "BOTTOM"|"B"=Bottom

inherited setVisible(visible, collapse)

BPMExt-Core/com/salientprocess/bpm/views/bpmext.js, line 1887
Show/hide this view/control
Name Type Description
visible boolean Visibility flag (true to show view, false to hide)
collapse boolean Set to true to collapse the control space when visible is set to false.
Examples
MyView.setVisible(false, false); //Equivalent to MyView.hide()
MyView.setVisible(false, true); // Sets visibility to "None"

inherited show()

BPMExt-Core/com/salientprocess/bpm/views/bpmext.js, line 1849
Show this view/control
Example
MyView.show();

inherited triggerFormulaUpdates(phase)

BPMExt-Core/com/salientprocess/bpm/views/bpmext.js, line 4229
Broadcasts the expression trigger for the specified view
Name Type Default Description
phase int bpmext.ui.PHASE_NORMAL optional The phase we are currently in
Example
MyView.triggerFormulaUpdates();