The Tickbox List question type

The Tickbox List question allows the user to select more than one option from a list of values. Users can see all options on the form and can tick the box next to their choice. Tick-boxes can have a default setting of selected or deselected.

Details Screen

The Details screen allows you to configure the settings of theTickbox List question. 

Question Options

This section allows you to customise the options for the Tickbox List question. The Question Options section is shown in the figure below:

The Question Options section

The following fields are available: 

• 
  The question asset

  Title: enter the question title, for example State. When you change the Title of the question, the asset name will change in the Asset Map, as shown in the figure to the right. This Title will appear on the Custom Form as the name of the question.
• Note: enter a note to be displayed for the question on the Custom Form. This can be used to provide information to your users about the question and the expected form of the response. For example Please select a state from the list.

• 
  The Options field

  Options: this section shows the values that have been added to the list and allows you to add new ones, delete existing ones or re-order the list. To add a new value to the list, click within a blank box, enter the value and click Commit. For example, enter NSW, QLD,ACT,VIC,TAS,NT,SA and WA and click Commit. You can enter as many options as you want at the same time and there is no limit to the number of options you can add to the list. To delete an option from the list, click the icon to the right of the text box. To re-order the list click on the up and down arrows and click Commit – if you do not click Commit the new order will not be saved.
• Default: select a default value for the list on the Custom Form. You will only be able to select a default value once you have specified the values for the list in the Options field. This value will be selected within the answer field on the form. The user can then override this value.
• Tab Index: enter the tab index for the Tickbox List question on the Custom Form. This index is used when the user press the Tab key on the keyboard. This is useful when you have laid out each question individually on the Page Contents Bodycopy. If this question is the first question on the Custom Form, but on the Page Contents Bodycopy you have put it last, you can enter the Tab Index so that when the user presses the Tab key, it will be the last question the cursor goes to.
• Extras: enter any additional HTML attributes to be added to the tag used to display the answer field for the question. For example, you may wish to specify a CSS class that defines the formatting of the question text.
• Sticky: select Yes to define the answer to this question as sticky for the remainder of this users session. If this option is set to Yes, the most recent value entered into this question is marked as sticky and will be used to pre-fill other forms with a question of the same name that also have the Sticky flag set to Yes. Any sticky value will override the default value for the question.

Simple Validation Rules

The Simple Validation Rules section of the Details screen allows you to select whether or not this question is mandatory. For more information on how the fields that are available, refer to the Questions chapter in this manual.

Complex Validation Rules

The Complex Validation Rules section of the Details screen allows you to add additional validation rules to the select question. For more information on how to add a rule, refer to the Questions chapter in this manual.
The complex validation rules that are available for the select question are as follows:

• Selection Limit: this rule allows you to validate how many options must be selected from the list. For example, if you want the user to select two options from the list select Must select more than this many options in the Operator field and enter 2 into the Number of Options. When the user fills out the Custom Form, if they have not selected two options they will receive an error message. The fields that are available for this rule are shown in the figure below.

  
  The Selection Limit Complex Validation Rule

  The fields available are as follows:
  • Operator: you can select from Must select exactly this many options, Must not select exactly this many options, Must select more than this many options, Must select less than this many options, Must select at least this many options, or Must select no more than this many options.
  • Number of Options: enter the number of options that must either be selected or not selected for the rule in the text box.
  • Condition: this field allows you to add a condition on the validation rule. For more information, refer to the Questions chapter in this manual.
  • Custom Error Text: enter a customised error message to show if this rule fails. If you do not enter an error message, a default message will appear similar to You have selected 1 option(s) at question "State" - you must select more than 2.
  • Delete?: to delete this validation rule, click the Delete box and click Commit.