RMP_Button

Button widget

new RMP_Button(conf)

This constructor allows you to create a button widget that can be inserted dynamically in your web interface

Parameters:

Name	Type	Description
conf	Object	JSON structure which contains the configuration of the button

Example

var conf = {"id":"id_button","label":"Execute","variable":[{"name":"my_variable","value":"foo"}],"action":"execute_script","executed-script":"YWxlcnQoInllZWVlZWVlZXMiKTs="};
var id_button= new RMP_Button(conf); 
id_widget.insertBefore(id_button);

Methods

getContainerIndex() → {String}

Returns:

the index of the container of the widget, it might be the index of the column if the widget is in an array or the index of the tab if it's in a tab panel

Type String

getElement() → {object}

This function returns the html object of the widget

Returns: object

getLabel() → {String}

Returns:

returns the label of the widget

Type String

getListOfMyVariables() → {object}

This function returns the list of variables of the widget

Returns: object

Example

   ["id8.label","id8.value"] for list or ["textvar"] for a text input

getMessage() → {String}

Returns:

returns the message field displayed to the connected user when the button is clicked

Type String

getMissingVariableMessage() → {String}

This function returns the message displayed if a mandatory widget's variable is missing

Returns: String

getName() → {String}

This function returns the id as string of the widget

Returns: String

getOnClickAction()

Returns the "On click" type ("show-message", "close", "redirect", "load-next")

getParent() → {object}

Returns:

the parent widget of a widget

Type object

getRedirectUrl() → {String}

Returns:

returns the redirect URL if the "On click" type is "Redirect"

Type String

getTooltip() → {String}

This function returns the tooltip text of the widget

Returns: String

getType() → {String}

This function returns the type of the widget(RMP_Image, RMP_Html, RMP_Scripter, RMP_StaticTextwidget, RMP_Button, RMP_TextInput, RMP_ListBox, RMP_MultiSelectionCheckBox, RMP_RadioButton, RMP_Array, RMP_FileUpload... )

Returns: String

getValidationVariableMessage() → {String}

This function returns the message displayed if a validation rule is not met

Returns: String

getValue() → {String}

This function returns the value of the widget's variable. It does not work for list's widgets (check box list, radio button list and list) where you should use widgetID.getSelectedValue.

Returns: String

getVariableValue(varName) → {String}

This function returns the value of a given variable of the widget

Parameters:

Name	Type	Description
varName	String

Returns: String

insertAbove(widget)

This function allows you to insert above widgetID, the new widget created thanks to new RMP_xxx() function

Parameters:

Name	Type	Description
widget	object	the inserted widget

insertAfter(widget)

This function allows you to insert on the left of widgetID, the new widget created thanks to new RMP_xxx() function

Parameters:

Name	Type	Description
widget	object	the inserted widget

insertBefore(widget)

This function allows you to insert on the right of widgetID, the new widget created thanks to new RMP_xxx() function

Parameters:

Name	Type	Description
widget	object	the inserted widget

***insertBelow(widget)

This function allows you to insert below widgetID, the new widget created thanks to new RMP_xxx() function

Parameters:

Name	Type	Description
widget	object	the inserted widget

isActive() → {boolean}

This function returns true if the widget is active and false otherwise

Returns: boolean

isCloseAfterAction() → {boolean}

Deprecated:-

Returns:

returns true if "Close windows" field is checked and false otherwise

Type boolean

isEmptyVariable(variable) → {boolean}

This function returns true if the the widget's variable is empty and false otherwise

Parameters:

Name	Type	Description
variable	String

Returns: boolean

isEnabled() → {boolean}

This function returns true if a widget is active and false otherwise

Returns: boolean

isIndexed() → {boolean}

This function returns true if the the widget's variable is an array and false otherwise

Returns:

Type boolean

isIndexedVariable(name) → {boolean}

This function returns true if the the widget's variable is an array and false otherwise

Parameters:

Name	Type	Description
name	String

Returns: boolean

isRequired() → {boolean}

This function returns true if the the widget's variable is required and false otherwise

Returns: boolean

isValid(checkRules) → {boolean}

This function returns true if the the widget's variable is valid and false otherwise

Parameters:

Name	Type	Description
checkRules	boolean

Returns: boolean

isValidVariable(varName) → {boolean}

This function returns true if the the widget's variable is valid and false otherwise

Parameters:

Name	Type	Description
varName	String

Returns: boolean

isVisible() → {boolean}

This function returns true if the widget is visible and false otherwise

Returns: boolean

moveAfter(widget)

This function allows you to move widgetID2 after (on the the right) widgetID1

Parameters:

Name	Type	Description
widget	object	the inserted widget

moveBefore(widget)

This function allows you to move widgetID2 before (on the left) widgetID1

Parameters:

Name	Type	Description
widget	object	the inserted widget

remove(widget)

This function allows you to remove widgetID. If removeVariable is set to true, it will also deleted content of variable attached to widget

Parameters:

Name	Type	Description
widget	object	the inserted widget

setActive(active)

This function allows to set the widget as active/inactive

Parameters:

Name	Type	Description
active	boolean	the inserted widget

setCloseAfterAction(close)

Parameters:

Name	Type	Description
close	Boolean

Deprecated: This function sets "Close windows" to yes if true and no otherwise

setEnabled(e)

This function allows to set a widget as active/inactive

Parameters:

Name	Type	Description
e	boolean

setLabel(text)

Sets the label of a widget

Parameters:

Name	Type	Description
text	String

setMessage(msg)

Sets the message field displayed to the connected user when the button is clicked

Parameters:

Name	Type	Description
msg	String

setMissingVariableMessage(msg)

This function sets the message displayed if a mandatory widget's variable is missing

Parameters:

Name	Type	Description
msg	String

setOnClickAction(action)

Sets the the "On click" type

Parameters:

Name	Type	Description
action	String

Example

"show-message", "close", "redirect", "load-next"

### setRedirectUrl(url)\

Sets the redirect URL if the "On click" type is "Redirect"

Parameters:

Name	Type	Description
url	String

setRequired(req)

This function sets the mandatory status of the widget's variable

Parameters:

Name	Type	Description
req	boolean

setTooltip(tooltip)

This function sets the tooltip text of the widget

Parameters:

Name	Type	Description
tooltip	String

setValidationVariableMessage(msg)

This function sets the message displayed if a validation rule is not met

Parameters:

Name	Type	Description
msg	String

setValue(value)

This function sets the value of the widget's variable. It does not work for list's widgets (check box list, radio button list and list) where you should use widgetID.setSelectedValue.

Parameters:

Name	Type	Description
value	String

setVariableValue(varName, value)

This function sets the value of a given variable of the widget

Parameters:

Name	Type	Description
varName	String
value	String

setVisible(v)

This function allows to set the widget as visible/invisible

Parameters:

Name	Type	Description
v	boolean