Class CheckboxValidationBuilder
Stay organized with collections
Save and categorize content based on your preferences.
CheckboxValidationBuilder
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);
Detailed documentation
requireSelectAtLeast(number)
requireSelectAtMost(number)
requireSelectExactly(number)
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-12-02 UTC.
[null,null,["Last updated 2024-12-02 UTC."],[[["\u003cp\u003e\u003ccode\u003eCheckboxValidationBuilder\u003c/code\u003e allows you to set validation rules for checkbox items in Google Forms.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify the minimum, maximum, or exact number of choices that must be selected.\u003c/p\u003e\n"],["\u003cp\u003eValidation rules can be customized with help text to guide users.\u003c/p\u003e\n"],["\u003cp\u003eIt is used with \u003ccode\u003eCheckboxItem\u003c/code\u003e to create and manage checkbox questions within forms.\u003c/p\u003e\n"]]],[],null,["# Class CheckboxValidationBuilder\n\nCheckboxValidationBuilder\n\nA DataValidationBuilder for a [CheckboxValidation](/apps-script/reference/forms/checkbox-validation).\n\n```javascript\n// Add a checkBox item to a form and require exactly two selections.\nconst form = FormApp.create('My Form');\nconst checkBoxItem = form.addCheckboxItem();\ncheckBoxItem.setTitle('What two condiments would you like on your hot dog?');\ncheckBoxItem.setChoices([\n checkBoxItem.createChoice('Ketchup'),\n checkBoxItem.createChoice('Mustard'),\n checkBoxItem.createChoice('Relish'),\n]);\nconst checkBoxValidation = FormApp.createCheckboxValidation()\n .setHelpText('Select two condiments.')\n .requireSelectExactly(2)\n .build();\ncheckBoxItem.setValidation(checkBoxValidation);\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|----------------------------------------------------------------|--------------------------------|----------------------------------------------------|\n| [requireSelectAtLeast(number)](#requireSelectAtLeast(Integer)) | [CheckboxValidationBuilder](#) | Require at least this many choices to be selected. |\n| [requireSelectAtMost(number)](#requireSelectAtMost(Integer)) | [CheckboxValidationBuilder](#) | Require at most this many choices to be selected. |\n| [requireSelectExactly(number)](#requireSelectExactly(Integer)) | [CheckboxValidationBuilder](#) | Require exactly this many choices to be selected. |\n\nDetailed documentation\n----------------------\n\n### `require``Select``At``Least(number)`\n\nRequire at least this many choices to be selected.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|-----------|-------------|\n| `number` | `Integer` | |\n\n#### Return\n\n\n[CheckboxValidationBuilder](#) --- this [CheckboxValidationBuilder](#), for chaining\n\n*** ** * ** ***\n\n### `require``Select``At``Most(number)`\n\nRequire at most this many choices to be selected.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|-----------|-------------|\n| `number` | `Integer` | |\n\n#### Return\n\n\n[CheckboxValidationBuilder](#) --- this [CheckboxValidationBuilder](#), for chaining\n\n*** ** * ** ***\n\n### `require``Select``Exactly(number)`\n\nRequire exactly this many choices to be selected.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|-----------|-------------|\n| `number` | `Integer` | |\n\n#### Return\n\n\n[CheckboxValidationBuilder](#) --- this [CheckboxValidationBuilder](#), for chaining"]]
