Single Line Textbox control

The Single Line Textbox control allows users to enter plain text on a form. You can also use this control to collect metadata. For more information, see Collect metadata from the app (optional).

This control is supported in Nintex Mobile, except for noted fields.

Control settings  

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

Note: Several settings allow selection of Yes, No, or Expression. Selecting Expression allows you to construct a formula from reference tokens and functions. 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.

Note: For information about the control properties tab in the Nintex Forms ribbon, see Control properties tab.

Section Field Description Nintex Mobile

General

Name

The name of the control. The name is used for comparison validation and other control references.

Yes

 

Title

(Responsive Forms Designer only)

Title of the control. The title is displayed as the label for the control.

Yes

 

Description

(Responsive Forms Designer only)

Description of the control. The description displays additional information or instructions for the control.

Yes

 

Connected to

The field to bind the input control to. For more information, see Connect controls to fields.

Yes

 

Default value source

Only available when connected, allows you to override the connected fields default with your own default expression.

Yes

 

Default value

Set a default value for the control. This value will only be used if a default value has not been specified in the column or variable selected in the Connected to setting.

Yes

 

Data Type

Only available when not connected. The data type to convert to during validation.

Yes

Appearance

Visible

Hide or show the control at runtime.

Yes

 

Enabled

​Enable the control to receive user input at run time.

Yes

Formatting

(Classic Forms Designer only)

Control CSS class

The CSS class to apply to the inner elements of the control.

Yes

 

CSS class

The CSS class to apply to the control. This is used to apply advanced styling options. The Custom CSS class is defined in Form Settings (refer to Form and Layout settings).

Yes

 

Border

​Draws a line along the select border of the control.

Yes

 

Border Style

The style of the border.

Yes

 

Border Width (Pixels)

​The width of the border in pixels.

Yes

 

Border Color

The color of the border. This can either be a HEX code or a named color that is supported by html.

Yes

 

Padding Width (Pixels)

The amount of padding in pixels that will appear between the top, left and right border and the inner control.

Yes

Validation

Required

The form will not submit unless this control is completed correctly.

If Yes is selected:

  • Required error message: The error message to display when the required field is not specified.

Yes

 

Compare To

Enables the value entered into the control to be validated against a specified value, or the current value in another control.

If Control is selected:

  • Compare operator: Select the type of comparison to perform.
  • Control to compare: Select the control to compare to.
  • Compare validation error message: The error message to display when an invalid value is entered.

If Value is selected:

  • Compare operator: Select the type of comparison to perform.
  • Value to compare: A fixed constant value to compare against the current value of the control.
  • Compare validation error message: The error message to display when an invalid value is entered.

Yes

 

Use range validation

Enables the value entered into the control to be validated against a specified maximum and minimum value.

If Yes is selected:

  • Maximum value: The maximum valid value.
  • Minimum value: The minimum valid value.
  • Range validation error message: The error message to display when an invalid value is entered.

Yes

 

Use a regular expression

Enables the value entered into the control to be validated against a regular expression.

If Yes is selected:

  • Regular expression: The regular expression string for validating the input against.
  • Regular expression validation message: The error message to display when an invalid value is entered.

Yes

 

Use custom validation

Enables the value entered into the control to be validated by a JavaScript function.

If Yes is selected:

  • Custom validation function: Specify the JavaScript function name for the client side custom validation. Note: The JavaScript function is to be specified in the Custom JavaScript section within the form's Settings.

E.g. The property should be ClientValidate when the following function is added to the custom JavaScript in the form.

function ClientValidate(source, arguments)

{

      if (arguments.Value % 2 == 0){

        arguments.IsValid = true;

      } else {

        arguments.IsValid = false;

      }

 }

  • Custom error message: The error message to display when an invalid value is entered.

Note:  Custom JavaScript is available in the Classic Forms Designer only.

Yes

Advanced

Max length

Only available when not connected. The maximum length of the text that can be entered.​

Yes

 

Password

Hide the password text with asterisks.

Yes

 

Help text

Text that will be displayed to the user as a tooltip to guide the completion of the form.

No

 

Control Mode

​Force control to be in Edit mode, Display mode, or set to Auto.

No

 

Convert empty string to null

Convert to a null value if the control contains an empty string.

No

 

Null display text

​If the bound value is null, this text will be displayed instead.

No

 

String format

The string format to apply to the value. The string format will be determined by the type of data specified by the control. When it is a number the following can be used http://msdn.microsoft.com/en-us/library/0c899ak8.aspx, and http://msdn.microsoft.com/en-us/library/dwhawy9k.aspx. For other types see http://msdn.microsoft.com/en-us/library/26etazsy.aspx

no

 

Store Client ID in JavaScript variable

A JavaScript Variable will be created that references the Client ID of this control.

If Yes is selected:

  • Client ID JavaScript variable name: The name of the variable to store the Client ID in.

Note:  Custom JavaScript is available in the Classic Forms Designer only.

No

 

Resize at runtime

Allow the control to dynamically adjust its size, and adjust the form length and position of other controls accordingly.

No

 

Enable barcode scanning

Displays a button next to the control for scanning barcodes. Available in supported Nintex Mobile apps only. Select one of the following options.

  • Yes
  • No

Yes

Related Topics

Forms designer
Control Settings
Connecting Controls to fields or variables
Controls In Use
Shortcut keys
Rich Text
Multi Line Textbox
Inserting reference fields
Control Properties Ribbon