Button control

Initiates an action, such as submitting a form or initiating custom JavaScript.

This feature is not supported in Nintex Mobile.

Note: The Button control is not needed for NintexMobile because the Save and Cancel buttons are generated individually by platform.

Control settings

Following are the fields and options visible in the control settings dialog box for this form control.

Note: CSS formatting controls are available in the classic forms designer only. To style responsive forms, configure theme settings in the Properties pane.

Section Field Description

General

Name

Assign a name to the control. The name is used for comparison validation and other control references.

Button action

Specify the function of the button. Select one of the following options.

  • Save: Saves entered data to the list and closes the form.
  • Save and Continue: Saves entered data to the list without validating for required controls (rule or control configuration).
  • Save and Submit: Saves entered data to the list and closes the form.
  • Cancel: Discards entered data and closes the form.
  • JavaScript: Option for specifying custom functionality.

Custom JavaScript is available in the classic forms designer only.

Button type

Specify the display type. Select one of the following options.

  • Button: Superimposes the text on a clickable rectangle.
  • Image: Displays the specified image within a clickable rectangle.
  • Link: Formats the text as a link.

Button label

Text to display on the button control. For Image type, displays text when image cannot be displayed.

ClosedHow do I insert a reference?

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

Appearance

Visible

Hide or show the control at runtime. Select one of the following options.

  • Yes
  • No

  • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.

ClosedHow do I insert a reference?

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

Horizontal width

The width of the control as a percentage (%), pixel, or point value. Default: 100%

ClosedHow do I insert a reference?

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

Vertical height

The height of the control as a percentage (%), pixel, or point value. Default: 100%

ClosedHow do I insert a reference?

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

Formatting (C)

CSS class

The CSS class to apply to the control.

Use this setting to apply advanced styling options using custom CSS classes defined in the form settings.

ClosedHow do I insert a reference?

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

Border

Specify borders to display. Select zero or more of the following options.

  • Top
  • Bottom
  • Left
  • Right

Border Style

Specify the style of the border line. Select one of the following options.

  • Default
  • None
  • Dotted
  • Dashed
  • Solid
  • Double
  • Groove
  • Ridge
  • Inset
  • Outset

Border Width (Pixels)

The width of the line in pixels.

Note: To hide the border, enter zero ("0").

ClosedHow do I insert a reference?

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

Border Color

The color of the line.

ClosedHow do I insert a reference?

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

Padding Width (Pixels)

The width of the padding between the edge of the control and the content of the control.

ClosedHow do I insert a reference?

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

Advanced

Visible when in view mode

Hide or show the control in view mode. Select one of the following options.

  • Yes

    • View mode text: The text displayed on the button when the form is in view mode.

      ClosedHow do I insert a reference?

      You can insert references into select fields for control, form, and layout settings.

      To insert a reference:

      1. Click the field.

        The Insert Reference pane appears on the right.

      2. Select the reference.
    • Enable when in view mode: Allow the button to operate when the form is in view mode.
      • Yes
      • No
      • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.
  • No

  • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.

    • View mode text: The text displayed on the button when the form is in view mode.

      ClosedHow do I insert a reference?

      You can insert references into select fields for control, form, and layout settings.

      To insert a reference:

      1. Click the field.

        The Insert Reference pane appears on the right.

      2. Select the reference.
    • Enable when in view mode: Allow the button to operate when the form is in view mode.
      • Yes
      • No
      • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.

Causes validation

(Displayed for the following button types: Save, Save and Submit, Cancel, JavaScript.) Apply validation for JavaScript button types. Select one of the following options.

  • Yes
  • No

  • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.

ClosedHow do I insert a reference?

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

Client click

(Displayed for the following button types: Save, Save and Submit, Cancel, JavaScript.) The JavaScript to execute when the user clicks the button.

ClosedHow do I insert a reference?

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

Connected to

The field to bind the input control to.

When a field is selected, the following fields appear.

  • Value returned: The value to return when the button is clicked.

    ClosedHow do I insert a reference?

    You can insert references into select fields for control, form, and layout settings.

    To insert a reference:

    1. Click the field.

      The Insert Reference pane appears on the right.

    2. Select the reference.

  • Data type returned: The data type of the returned value when the button is clicked. Select one of the following options.

    • String
    • Integer
    • Decimal
    • Date
    • Currency

Confirmation message

Prompts the user for confirmation when the button is clicked during runtime, displaying the specified text. If no text is specified, then the user is not prompted for confirmation.

ClosedHow do I insert a reference?

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

Resize at runtime

Dynamically adjust size and adjust the form length and position of other controls accordingly. Select one of the following options.

  • Yes
  • No

  • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.

ClosedHow do I insert a reference?

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

Close the form

(Displayed for the following button types: Save and Continue.) Closes the form when the button is clicked. Default value: No

Redirect URL

(Displayed for the following button types: Save, Save and Submit, Cancel.) ​The URL to redirect to after the form is closed through this button control.

(C): Available with the classic designer only.

Forms