Number

The Number form control allows users to enter a numeric value into a form field. You can configure the Numeric control to accept integer or decimal value, and set minimum and maximum values.

The Number control inherits regional settings from the browser and passes decimal values with the decimal point separator to the workflow.

The functionality of this control has been enhanced with the switch to the new workflow engine. For more information about the workflow engine, see Workflow engine.

Previous behavior New behavior

If the Number control is configured, such that the Numeric type in the configuration panel is set to Decimal, values that are entered as whole numbers are stored as is. For example, 123 is stored as 123.

If the Number control is configured, such that the Numeric type in the configuration panel is set to Decimal, values that are entered as whole numbers are stored as decimal numbers. For example, 123 is stored as 123.0.

To remove "0," set the Numeric type of the control to Integer or use the Apply a regular expression action.

Note: You can arrange up to six of this control on a single row in the form.

Setting Setting Description
(unlabeled) Title

Field name displayed on the published form.

 

Customize

Switch toggle to Yes to enable customization of the variable Name of the form control.

 

Name

(This field becomes configurable only when you switch the Customize toggle to Yes.)

Customizes the name of the variable A placeholder that stores changes each time the workflow runs, such as the information entered in a form, or the name of a file. You can also create variables to store information you use in the workflow, such as an email address. for the field. If the name is not customized, the Title will be used as the variable name.

 

Numeric type

The required type of number value for user entry in this field:

  • Integer
  • Decimal
 

Default value

The value that automatically populates the field when the form loads.

Click in this field, and then click Insert to launch the Formula builder where you can create variables with applied formulas. The calculated value becomes the default value.

 

Range validation

Enables or disables the ability to set a lower and/ or upper limit for the number value which can be submitted for the field, and to display an error if the value does not meet the defined range.

 

Minimum value

(Displays when you enable Range validation)

The lower limit of the valid range for a numeric value that can be submitted in the field.

 

Maximum value

(Displays when you enable Range validation)

The upper limit of the valid range for a numeric value that can be submitted in the field.

 

Custom validation message

(Displays when you enable Range validation)

The text which displays below the number field when the value is not between the maximum and minimum value range.

 

Required

Mandates entry of a value before the form can be submitted.

 

Custom required message

(Displays when you enable Required)

The text which displays below the field when a value is not entered into the field upon change form page or on form submit.

 

Visible

Shows the field on the published form when loaded.

 

Read-only

Displays the field on the published form but does not allow user input.

 

Placeholder

Default text displayed in the field on the published form. This default text disappears when the user types the first valid character inside the field.

 

Description

A description of the field to display below the field on the published form.

 

Tooltip

The message which appears when users hover their cursor or touch the information icon beside the Number control in the form.

  Shrink Reduces the width of the control when placed in a row with other form controls.
  Expand Increases the width of the control when placed in a row with other form controls.
Styling CSS class

Add a CSS class to apply a style to this form control. You can create the CSS class in the CSS code editor in form styles. Enter one class name or multiple class names separated by a space.

For more information, see Add a custom CSS to individual controls.

Note: The CSS Class field is available only if the Custom CSS setting is enabled in Nintex Automation Cloud Form settings.

Border color

Border color to apply to the field.

To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code.

To revert back to the global style, click Reset to global style.

  Control fill

The color to fill the inside of the field.

To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code.

To revert back to the global style, click Reset to global style.

  Control input color

The font color of the input in the field.

To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code.

To revert back to the global style, click Reset to global style.