The next table presents the properties of the Button widget.

Property

Description

Optionality

Default value

Obs.

Name

Name of the widget used in the screen scope.

Optional

 

Although optional, only named widgets are available in the scope of the screen or web block. Only then can you use their runtime properties and select them using the widget selector.

See rules for naming elements.

Label

Expression that is evaluated at runtime and set as the button label.

For the Button label to be constant, set the expression to have only literal values.

Optional

 

"Ok"

 

You should define a meaningful label.

Example

Text to display on the Content Canvas in Preview and Design modes.

Optional

 

 

Validation Parent

Allows you to bind the Button widget to a specific Edit Record widget.

You can select the Edit Record from a drop-down list with the Edit Record widgets currently placed in the screen or screen block.

If this property is set to, for example, EditRecord1, when the button is pressed, the Mandatory and Data Type validations are only applied to the input widgets that have also EditRecord1 as their Parent Edit Record.

If this property is left empty, when the button is pressed, the Mandatory and Data Type validations are applied to all input widgets in the screen.

Optional

When the widget is implicitly created by dragging an attribute or entity into an Edit Record, this property will be set by default to <entity_name>_<attribute_name>, for example Customer_Address.

In any other case it's empty by default.

Specifying this property will place the Button widget inside the Edit Record widget, in the screen Scope Tree.

Width

Indicates the width of the widget. You can change the width by editing this property or by resizing it using the Grid in the Content Canvas.

Optional

 

The value of this property can be in columns, pixels, points, or percentage.

Height

Visual height of the widget. If the unit is not specified, Service Studio uses pixels. However you can specify the height in cm, inches, or % of the screen.

Optional

 

 

Margin Left

Indicates the width of the left margin of the widget.

This value can be automatically set by the Grid.

Optional

Auto

The value of this property can be in pixels, points, or percentage.

If not defined and the widget style defines a margin-left then this margin is applied to the widget.

Margin Top

Indicates the height of the top margin of the widget.

This value can be automatically set by the Grid.

Optional

Auto

The value of this property can be in pixels or points.

If Auto is selected and the widget style defines a margin-top then this margin is applied to the widget.

Style

Drop-down list with the styles that can be applied to the button.

Optional

Button

Learn more About Style Sheets.

Double-click on the property and the Style Sheet Editor is opened with the current style already selected.

Visible

When this property is false, the HTML page, generated at runtime, does not include the HTML tag that corresponds to this widget.

Mandatory

True

You can directly type the values true or false, select a variable that handles this (if the variable is not of type Boolean, an error message is presented and the eSpace is not valid) or use the Expression editor.

Enabled

Allows you to specify whether the end-user can interact with the eSpace through this widget. When this property is set to false, the button is presented but nothing happens when the end-user presses it.

You can directly type the values true or false, select a variable that handles this (if the variable is not of type Boolean, an error message is presented and the eSpace is not valid) or use the Expression editor.

Mandatory

True

If this property is false, the disabled attribute is added to the <input type = "submit"> HTML tag that corresponds to this widget. Learn more about how widgets are translated into HTML tags.

Is Default

Indicates whether the Button is the default button or link in the screen or screen block.

Mandatory

No

Learn more about the default button or link.

On Click - Grouped properties in the context of clicking with the pointing device over the widget.

Method

Indicates how the inputs entered by the end-user are submitted. The possible values are:

Submit: the inputs are submitted. Uses the POST HTTP method.

Ajax Submit: some of the inputs are asynchronously submitted (using Ajax techniques) while keeping the state of the web screen.

Navigate: the inputs are ignored. Uses the GET HTTP method.

Mandatory

Submit

Learn more about the different behaviors of the Button widget.

Validation

Indicates whether you want to validate the typed values and where this validation takes place. The validations provided by the Service Studio for the input widgets are made regarding the data types and mandatory data.

The possible values are: '(none)' means that no validation is performed; 'Server' means that input values are validated in the server side, after submitting the request; 'Client & Server' means that inputs are validated in the browser side and only if they are valid, the request is submitted to the server.

Mandatory

Server

The Parent Edit Record property defines which inputs are used in the validation.

For more information, see Validate End-User Inputs.

Confirm Message

Message displayed to confirm that you really want to go to the destination (either screen or action).

You can type the message directly or use the Expression editor.

This property is evaluated during the rendering of the web screen, which means that values provided by the end-user have not been submitted when the expression was evaluated.

Optional

 

If the end-user does not confirm the operation, the flow remains in the same web screen. Neither the action nor the screen associated with the screen are executed.

Destination

A list of possible screens and possible actions is displayed. Simply choose one of these.

The possible destinations are:

  • (New Action) that creates a new screen action.

  • All the screen actions created for the current screen, sorted by name.

  • (Current Screen).

  • All the screens you are already connected to, sorted by name.

  • (Another Destination...) to choose another screen.

Mandatory

 

 

 

Destination Arguments

The list of arguments that corresponds to the input parameters of the screen action or web screen (depending on the Destination). The values of the parameters must be of the same type as the input parameters.

NA

NA

The argument is mandatory or optional, if the parameter in the destination screen is respectively mandatory or optional.

Extended Properties - Additional properties for attributes and/or events that implement specific behaviors of your widget.

Name

Name of the attribute that the HTML element can accept as specified in the HTML language reference.

NA

 

 

This property is added to the <input type = "submit"> HTML tag that corresponds to this widget.

Learn more about Extending Properties and how widgets are translated into HTML tags.

Value

The value for the attribute.

NA

 

This property is added to the <input type = "submit"> HTML tag that corresponds to this widget.

Learn more about Extending Properties and how widgets are translated into HTML tags.

See Also

About Button Widget | Button Widget Runtime Properties