Single Line Textbox control

Allows users to enter plain text on a form. You can also use this control to collect metadata.

Note: 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: 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 Nintex Mobile

General

Name

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

Yes

 

Title (R)

Text to display above the field on the published form. Acts as a label for the control.

Yes

 

Description (R)

Helper text to display under the field on the published form.

Yes
 

Connected to

The field to bind the input control to.

Yes
 

Default value

Set a default value for the control. This value is used if no default value is specified for the connected field (Connected to).

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.

For more information, see Insert References.

Yes
 

Data Type

The data type to convert to during validation. Select one of the following options.

  • String
  • Integer
  • Decimal
  • Currency

Yes

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.

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.

For more information, see Insert References.

Yes

 

Enabled

Enable the control to receive user input at run time. 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.

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.

For more information, see Insert References.

Yes

Formatting (C)

Control CSS class

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

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.

For more information, see Insert References.

Yes
 

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.

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.

For more information, see Insert References.

Yes
 

Border

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

  • Top
  • Bottom
  • Left
  • Right

Yes
 

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

Yes
 

Border Width (Pixels)

The width of the line in pixels.

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

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.

For more information, see Insert References.

Yes
 

Border Color

The color of the line.

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.

For more information, see Insert References.

Yes
 

Padding Width (Pixels)

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

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.

For more information, see Insert References.

Yes

Validation

Required

Specify whether you want to mandate entry of a value for this field before the form is submitted. Select one of the following options.

  • Yes: Mandates entry of a value for this field.

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

  • No: Entry for this field is not mandatory.

  • 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.

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

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.

For more information, see Insert References.

Yes
 

Compare To

Specify a value for validation of the control. Select one of the following options.

  • None
  • Control: Validate the value entered into the control against the current value in another control.

    • Compare operator: Type of comparison to perform. Select one of the following options.

      • Equal
      • Not equal
      • Greater than
      • Greater than or equal
      • Less than
      • Less than or equal
    • Control to compare: Control to compare to.

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

  • Value: Validate the value entered into the control against a specified value.

    • Compare operator: Type of comparison to perform. Select one of the following options.

      • Equal
      • Not equal
      • Greater than
      • Greater than or equal
      • Less than
      • Less than or equal

    • 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. 

    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.

    For more information, see Insert References.

Yes
 

Use range validation

Minimum and maximum values for the validation. Select one of the following options.

  • Yes

    • 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.

    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.

    For more information, see Insert References.

  • No

Yes
 

Use a regular expression

Regular expression for the control validation. Select one of the following options.

  • Yes

    • 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.

    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.

    For more information, see Insert References.

  • No

Yes
 

Use custom validation (C)

JavaScript function for the control validation.

  • Yes

    • 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 settings.

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

    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.

    For more information, see Insert References.

  • No

Custom JavaScript is available in the classic forms designer only.

Yes

Advanced

Max length

(Displayed when the control is not connected to a field.) Specify the maximum number of characters that can be entered. Maximum characters: 256.

Yes
 

Password

Specify whether or not to hide the password text with asterisks. 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.

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.

For more information, see Insert References.

Yes
 

Help text

Text to display as a tooltip to guide the completion of the form.

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.

For more information, see Insert References.

No
 

Control Mode

Select one of the following options.

  • Auto
  • Edit: Force control be in edit mode.
  • Display: Force control to be in display mode.

No
 

Convert empty string to null

Convert to a null value if the control contains an empty string. 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.

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.

For more information, see Insert References.

No
 

Null display text

Value to display if the bound value is null.

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.

For more information, see Insert References.

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 (C)

Specify whether or not to store the client ID in a JavaScript variable. Select one of the following options.

  • Yes: A JavaScript variable is created to reference the client ID of this control.

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

    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.

    For more information, see Insert References.

  • No

Custom JavaScript is available in the classic forms designer only.

No
 

Resize at runtime (C)

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.

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.

For more information, see Insert References.

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

The following barcode formats are supported.

  • UPC-A and UPC-E
  • EAN-8 and EAN-13
  • Code 39
  • Code 93
  • Code 128
  • ITF
  • Codabar
  • RSS-14 (all variants)
  • QR Code
  • Data Matrix
  • Aztec ("beta" quality)
  • PDF 417 ("alpha" quality)

For information on scanning barcodes in Nintex Mobile, see "Scanning barcodes" in the Nintex Mobile Applications help.

Yes

(R): Available with the responsive designer only.

(C): Available with the classic designer only.