Page Summary
-
CheckboxValidationBuilder is used to create validation rules for checkbox items in a form.
-
It allows you to require a specific number of choices to be selected using methods like
requireSelectAtLeast,requireSelectAtMost, andrequireSelectExactly. -
These methods take an integer as a parameter to specify the required number of selections.
A DataValidationBuilder for a CheckboxValidation
.
// Add a checkBox item to a form and require exactly two selections. const form = FormApp . create ( 'My Form' ); const checkBoxItem = form . addCheckboxItem (); checkBoxItem . setTitle ( 'What two condiments would you like on your hot dog?' ); checkBoxItem . setChoices ([ checkBoxItem . createChoice ( 'Ketchup' ), checkBoxItem . createChoice ( 'Mustard' ), checkBoxItem . createChoice ( 'Relish' ), ]); const checkBoxValidation = FormApp . createCheckboxValidation () . setHelpText ( 'Select two condiments.' ) . requireSelectExactly ( 2 ) . build (); checkBoxItem . setValidation ( checkBoxValidation );
Methods
| Method | Return type | Brief description |
|---|---|---|
Checkbox
|
Require at least this many choices to be selected. | |
Checkbox
|
Require at most this many choices to be selected. | |
Checkbox
|
Require exactly this many choices to be selected. |
Detailed documentation
requireSelectAtLeast(number)
Require at least this many choices to be selected.
Parameters
| Name | Type | Description |
|---|---|---|
number
|
Integer
|
Return
CheckboxValidationBuilder
— this CheckboxValidationBuilder
, for chaining
requireSelectAtMost(number)
Require at most this many choices to be selected.
Parameters
| Name | Type | Description |
|---|---|---|
number
|
Integer
|
Return
CheckboxValidationBuilder
— this CheckboxValidationBuilder
, for chaining
requireSelectExactly(number)
Require exactly this many choices to be selected.
Parameters
| Name | Type | Description |
|---|---|---|
number
|
Integer
|
Return
CheckboxValidationBuilder
— this CheckboxValidationBuilder
, for chaining
