Reflects the current release of Nintex for SharePoint 2016. For your version, please access assistance through the Help button in the product.
The Choice control can be used to make a single or multiple selection on a form.
This control is supported in Nintex Mobile, except for noted fields.
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 |
|
Display format |
Select the type of choice control to display. (Option buttons / Checkbox / List / Drop down) |
Yes |
|
Choices |
Enter the choices to be displayed. |
Yes |
|
|
Default value source |
Select whether the default value will be inherited from the column definition or whether another specified value will be used. |
|
Default value |
Set a default value for the control. If a control is connected to a SharePoint list column, enter the value or expression value to override the Choice default specified in the SharePoint column. |
Yes |
|
|
Render as buttons |
When Display Format is set to Options Buttons (also known as "radio buttons" this allows the control to be rendered as styled buttons which can appear like tabs. By using this option with Rules a basic tab-like interface can be built on your form. |
No |
Arrange choices |
Items can be arranged across then down or down then across. |
Yes |
|
Number of columns |
Number of columns to use to display the specified choices. |
Yes |
|
|
Column alignment |
Align the choices in fixed columns or allow them to float. |
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. |
No |
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). |
No |
|
Border |
Draws a line along the select border of the control. |
No |
|
Border Style |
The style of the border. |
No |
|
Border Width (Pixels) |
The width of the border in pixels. |
No |
|
Border Color |
The color of the border. This can either be a HEX code or a named color that is supported by html. |
No |
|
Padding Width (Pixels) |
The amount of padding in pixels that will appear between the top, left and right border and the inner control. |
No |
|
Validation |
Required |
The form will not submit unless this control is completed correctly. If Yes is selected:
|
Yes |
Data Type |
The data type to convert to during validation. |
No |
|
Use custom validation |
Enables the value entered into the control to be validated by a JavaScript function. If Yes is selected:
Note: Custom JavaScript is available in the Classic Forms Designer only.
|
No |
|
Advanced |
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 |
|
Store Client ID in JavaScript variable |
A JavaScript Variable will be created that references the Client ID of this control. If Yes is selected:
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 |
|
|
Allow semicolon in choices |
Determines how the semicolon character is interpreted when rendering choices in the published form, regardless of configuration source (connected field or Choices in control configuration). Choose one of the following options.
|
No |
Forms designer
Control Settings
Controls In Use
Connecting Controls to fields or variables
Shortcut keys
Yes-No Control
Inserting reference fields
Control Properties Ribbon