Choice control

Use the Choice control to present one or more options in a published form for users to make a selection. You can specify one or multiple choices to be displayed as check boxes, drop-down list, list or option buttons.

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

 

Display format

(Available when no field is selected for Connected to.) Type of choice control to display. Select one of the following options.

  • Check boxes (Multiple-Selection)
  • Drop down list
  • List (Multiple-Selection)
  • Option buttons

Yes

 

Choices

Enter the one or multiple choices to be displayed in the form. The choice/s you enter is displayed on the published form as options for the user to select from. Separate each choice with a comma.

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

Yes

 

Arrange choices

(Available for the display formats Check boxes (Multiple-Selection) and Option buttons.) Specify arrangement of the choices and how choices are displayed through the columns when you have more than 1 column. Select one of the following options.

  • Across then down
  • Down then across

Yes

 

Number of columns

(Available for the display formats Check boxes (Multiple-Selection) and Option buttons.) 

Number of columns to use to display the specified choices.

Yes

 

Column alignment

(Available only for the display formats Check boxes (Multiple-Selection) and Option buttons.) 

Specify the column alignment to align the choices. The default setting is Fixed.

Fixed: Aligns choices in fixed columns. If the number of columns you specify in the Number of columns field is 2, the choices will be displayed in 2 columns.

Float: Groups your choices based on the number of columns and displays the choices in a column.

Note: 
  • Fixed alignment renders the columns inside an HTML table as <td> tags.
  • Float: Renders the columns as HTML DIVs.

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.

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.

Yes

Formatting (C)

Control CSS class

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

No

 

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.

No

 

Border

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

  • Top
  • Bottom
  • Left
  • Right

No

 

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

No

 

Border Width (Pixels)

The width of the line in pixels.

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

No

 

Border Color

The color of the line.

No

 

Padding Width (Pixels)

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

No

Validation

Required (C)

Specify whether or not validation of correct form completion is required on submission. Select one of the following options.

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

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

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

Yes

 

Data Type

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

  • String
  • Integer
  • Decimal
  • Date
  • Currency

No

 

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.

  • No

Custom JavaScript is available in the classic forms designer only.

No

Advanced

Help text

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

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

 

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.

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

No

(R): Available with the responsive designer only.

(C): Available with the classic designer only.

Forms