Class CheckboxValidationBuilder
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
أداةإنشاءعمليات التحقّق من مربّعات الاختيار
عنصر DataValidationBuilder لعنصر 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);
مستندات تفصيلية
requireSelectAtLeast(number)
requireSelectAtMost(number)
requireSelectExactly(number)
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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"]]