Class ParagraphTextValidationBuilder
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
أداةإنشاءعملياتالتحقّق من الفقرات النصية
عنصر DataValidationBuilder لعنصر ParagraphTextValidation
.
// Add a paragraph text item to a form and require the answer to be at least 100
// characters.
const form = FormApp.create('My Form');
const paragraphTextItem =
form.addParagraphTextItem().setTitle('Describe yourself:');
const paragraphtextValidation =
FormApp.createParagraphTextValidation()
.setHelpText('Answer must be more than 100 characters.')
.requireTextLengthGreaterThan(100);
paragraphTextItem.setValidation(paragraphtextValidation);
مستندات تفصيلية
requireTextContainsPattern(pattern)
requireTextDoesNotContainPattern(pattern)
requireTextDoesNotMatchPattern(pattern)
يجب أن لا تتطابق الإجابة مع النمط.
المعلمات
الاسم | النوع | الوصف |
pattern | String | يجب ألا يتطابق النص مع النمط. |
الإرجاع
ParagraphTextValidationBuilder
— هذا للربط
requireTextLengthGreaterThanOrEqualTo(number)
تتطلّب هذه السمة أن يكون طول الاستجابة أكبر من القيمة أو يساويها.
المعلمات
الاسم | النوع | الوصف |
number | Integer | يجب أن يكون طول نص الفقرة أكبر من هذه القيمة. |
الإرجاع
ParagraphTextValidationBuilder
— هذا للربط
requireTextLengthLessThanOrEqualTo(number)
تتطلّب هذه السمة أن يكون طول الاستجابة أقل من القيمة.
المعلمات
الاسم | النوع | الوصف |
number | Integer | يجب أن يكون طول نص الفقرة أقل من أو يساوي هذه القيمة. |
الإرجاع
ParagraphTextValidationBuilder
— هذا للربط
requireTextMatchesPattern(pattern)
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eParagraphTextValidationBuilder\u003c/code\u003e lets you set validation rules for paragraph text responses in Google Forms.\u003c/p\u003e\n"],["\u003cp\u003eYou can enforce rules like minimum/maximum text length, and require or exclude specific patterns in the text.\u003c/p\u003e\n"],["\u003cp\u003eAll validation methods return the \u003ccode\u003eParagraphTextValidationBuilder\u003c/code\u003e object itself, enabling method chaining for concise code.\u003c/p\u003e\n"],["\u003cp\u003eUse this class with \u003ccode\u003eFormApp.createParagraphTextValidation()\u003c/code\u003e to define the validation for a paragraph text item.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the detailed documentation and method table for specifics on each validation rule and its parameters.\u003c/p\u003e\n"]]],[],null,["# Class ParagraphTextValidationBuilder\n\nParagraphTextValidationBuilder\n\nA DataValidationBuilder for a [ParagraphTextValidation](/apps-script/reference/forms/paragraph-text-validation).\n\n```javascript\n// Add a paragraph text item to a form and require the answer to be at least 100\n// characters.\nconst form = FormApp.create('My Form');\nconst paragraphTextItem =\n form.addParagraphTextItem().setTitle('Describe yourself:');\nconst paragraphtextValidation =\n FormApp.createParagraphTextValidation()\n .setHelpText('Answer must be more than 100 characters.')\n .requireTextLengthGreaterThan(100);\nparagraphTextItem.setValidation(paragraphtextValidation);\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|--------------------------------------------------------------------------------------------------|-------------------------------------|----------------------------------------------------------------|\n| [requireTextContainsPattern(pattern)](#requireTextContainsPattern(String)) | [ParagraphTextValidationBuilder](#) | Requires response to contain pattern. |\n| [requireTextDoesNotContainPattern(pattern)](#requireTextDoesNotContainPattern(String)) | [ParagraphTextValidationBuilder](#) | Requires response to not contain pattern. |\n| [requireTextDoesNotMatchPattern(pattern)](#requireTextDoesNotMatchPattern(String)) | [ParagraphTextValidationBuilder](#) | Requires response to not match pattern. |\n| [requireTextLengthGreaterThanOrEqualTo(number)](#requireTextLengthGreaterThanOrEqualTo(Integer)) | [ParagraphTextValidationBuilder](#) | Requires response length to be greater than or equal to value. |\n| [requireTextLengthLessThanOrEqualTo(number)](#requireTextLengthLessThanOrEqualTo(Integer)) | [ParagraphTextValidationBuilder](#) | Requires response length to be less than value. |\n| [requireTextMatchesPattern(pattern)](#requireTextMatchesPattern(String)) | [ParagraphTextValidationBuilder](#) | Requires response to match pattern. |\n\nDetailed documentation\n----------------------\n\n### `require``Text``Contains``Pattern(pattern)`\n\nRequires response to contain pattern.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------|----------|---------------------------|\n| `pattern` | `String` | text must contain pattern |\n\n#### Return\n\n\n[ParagraphTextValidationBuilder](#) --- this for chaining\n\n*** ** * ** ***\n\n### `require``Text``Does``Not``Contain``Pattern(pattern)`\n\nRequires response to not contain pattern.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------|----------|-------------------------------|\n| `pattern` | `String` | text must not contain pattern |\n\n#### Return\n\n\n[ParagraphTextValidationBuilder](#) --- this for chaining\n\n*** ** * ** ***\n\n### `require``Text``Does``Not``Match``Pattern(pattern)`\n\nRequires response to not match pattern.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------|----------|-----------------------------|\n| `pattern` | `String` | text must not match pattern |\n\n#### Return\n\n\n[ParagraphTextValidationBuilder](#) --- this for chaining\n\n*** ** * ** ***\n\n### `require``Text``Length``Greater``Than``Or``Equal``To(number)`\n\nRequires response length to be greater than or equal to value.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|-----------|-------------------------------------------------------|\n| `number` | `Integer` | paragraph text length must be greater than this value |\n\n#### Return\n\n\n[ParagraphTextValidationBuilder](#) --- this for chaining\n\n*** ** * ** ***\n\n### `require``Text``Length``Less``Than``Or``Equal``To(number)`\n\nRequires response length to be less than value.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|-----------|----------------------------------------------------------------|\n| `number` | `Integer` | paragraph text length must be less than or equal to this value |\n\n#### Return\n\n\n[ParagraphTextValidationBuilder](#) --- this for chaining\n\n*** ** * ** ***\n\n### `require``Text``Matches``Pattern(pattern)`\n\nRequires response to match pattern.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------|----------|-------------------------|\n| `pattern` | `String` | text must match pattern |\n\n#### Return\n\n\n[ParagraphTextValidationBuilder](#) --- this for chaining"]]