Choice - Single
Use the Choice - Single form control to allow users to make one selection from multiple options you have defined.
Note: You can arrange up to six of this control on a single row in the form.
To view video tutorials on how to use this Nintex capability, go to Nintex University |
Section | 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. |
|
Display type |
Displays the user-selectable options using the selected type:
|
|
Options |
Options to display on the form. Click in this field, and then click Insert to launch the Formula builder where you can create and then insert a data variable with applied formulas, a collection, or a collection of objects. Or, enter each option in a new line. You can include commas in the options, if required (for example, Melbourne, Victoria can be one option). You can also include pipes/vertical bars "|" to define the options and their values (for example, Choice 1 | 1234 can be one option where Choice 1 is the option's label and 1234 is the option's value). You can also add Rules to create business logic to pre-select options based on the option's value. This can help users more quickly complete forms and ensure data integrity before the form is submitted. When using rules with options, select the options entered in the control on the Rules tab. |
|
Option configuration | Option label |
(Displays when you insert a data variable with a collection in the Options field.) Displays selected option data to the form viewer. |
Option value |
(Displays when you insert a data variable with a collection in the Options field.) Sends the corresponding selected value back to the workflow. |
|
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. |
|
Filter out duplicate options |
Switch toggle to Yes to filter options by value regardless of their label. When this is enabled, if there are duplicate options, only the first option is displayed in the form. The filtered options may change due to dynamic data. |
|
Allow a fill-in option |
(Displays when the display type is radio buttons.) Switch toggle to Yes to add "Other" option to enable users to type a custom option. |
|
Display 'Please select' |
(Displays when the display type is a drop-down list.) Switch toggle to Yes to display the 'Please select' text in the drop-down list. |
|
Alignment |
Orientation for display of the list of user-selectable options:
|
|
Required |
Mandates entry of a value before the form can be submitted. |
|
Custom required message |
(Displays when you select Yes in Required.) The validation text which displays below the field when a value is not entered into the field and the user attempts to change page or submit the form. |
|
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. |
|
Description |
Helper text displayed below the field on the published form. |
|
Tooltip |
The message which appears when users hover their cursor or touch the information icon beside the Choice - Single control in the form. |
|
Shrink | Reduces the width of the Single choice control in a row of other form controls. | |
Expand | Increases the width of the Single choice control in a row of 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. |