Class TextValidationBuilder

أداةإنشاءعمليات التحقّق من النص

عنصر DataValidationBuilder لعنصر TextValidation.

// Add a text item to a form and require it to be a number within a range.
const form = FormApp.create('My form');
const textItem =
    form.addTextItem().setTitle('Pick a number between 1 and 100?');
const textValidation =
    FormApp.createTextValidation()
        .setHelpText('Input was not a number between 1 and 100.')
        .requireNumberBetween(1, 100)
        .build();
textItem.setValidation(textValidation);

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
requireNumber()	TextValidationBuilder	يتطلب عنصر النص أن يكون رقمًا.
requireNumberBetween(start, end)	TextValidationBuilder	تتطلّب هذه السمة أن يكون العنصر النصي رقمًا بين البدء والنهاية، بما في ذلك.
requireNumberEqualTo(number)	TextValidationBuilder	تتطلّب هذه الدالة أن يكون العنصر النصي رقمًا يساوي القيمة المحدّدة.
requireNumberGreaterThan(number)	TextValidationBuilder	تتطلّب هذه الدالة أن يكون العنصر النصي رقمًا أكبر من القيمة المحدّدة.
requireNumberGreaterThanOrEqualTo(number)	TextValidationBuilder	تتطلّب هذه السمة أن يكون العنصر النصي رقمًا أكبر من أو يساوي القيمة المحدّدة.
requireNumberLessThan(number)	TextValidationBuilder	تتطلّب هذه السمة أن يكون العنصر النصي رقمًا أقل من القيمة المحدّدة.
requireNumberLessThanOrEqualTo(number)	TextValidationBuilder	تتطلّب هذه السمة أن يكون العنصر النصي رقمًا أقل من أو يساوي القيمة المحدّدة.
requireNumberNotBetween(start, end)	TextValidationBuilder	تتطلّب هذه السمة أن يكون العنصر النصي رقمًا لا يقع بين البدء والنهاية.
requireNumberNotEqualTo(number)	TextValidationBuilder	يتطلّب هذا الشرط أن يكون العنصر النصي رقمًا لا يساوي القيمة المحدّدة.
requireTextContainsPattern(pattern)	TextValidationBuilder	يجب أن يحتوي الردّ على نمط.
requireTextDoesNotContainPattern(pattern)	TextValidationBuilder	يجب ألا يحتوي الردّ على نمط.
requireTextDoesNotMatchPattern(pattern)	TextValidationBuilder	يجب أن لا تتطابق الإجابة مع النمط.
requireTextIsEmail()	TextValidationBuilder	يتطلب أن يكون العنصر النصي عنوان بريد إلكتروني.
requireTextIsUrl()	TextValidationBuilder	تتطلّب أن يكون العنصر النصي عنوان URL.
requireTextLengthGreaterThanOrEqualTo(number)	TextValidationBuilder	تتطلّب هذه السمة أن يكون طول الاستجابة أكبر من القيمة أو يساويها.
requireTextLengthLessThanOrEqualTo(number)	TextValidationBuilder	تتطلّب هذه السمة أن يكون طول الاستجابة أقل من القيمة.
requireTextMatchesPattern(pattern)	TextValidationBuilder	يجب أن تتطابق الإجابة مع النمط.
requireWholeNumber()	TextValidationBuilder	يتطلب هذا الحقل أن يكون العنصر النصي عددًا صحيحًا.

مستندات تفصيلية

requireNumber()

يتطلب عنصر النص أن يكون رقمًا.

الإرجاع

TextValidationBuilder — هذا TextValidation، لإنشاء سلسلة

---

requireNumberBetween(start, end)

تتطلّب هذه السمة أن يكون العنصر النصي رقمًا بين البدء والنهاية، بما في ذلك.

المعلمات

الاسم	النوع	الوصف
start	Number	الحدود الدنيا للنطاق الشامل
end	Number	الحدود العليا للنطاق الشامل

الإرجاع

TextValidationBuilder — هذا TextValidation، لإنشاء سلسلة

---

requireNumberEqualTo(number)

تتطلّب هذه الدالة أن يكون العنصر النصي رقمًا يساوي القيمة المحدّدة.

المعلمات

الاسم	النوع	الوصف
number	Number	القيمة التي يجب أن يساويها العنصر

الإرجاع

TextValidationBuilder — هذا TextValidation، لإنشاء سلسلة

---

requireNumberGreaterThan(number)

تتطلّب هذه الدالة أن يكون العنصر النصي رقمًا أكبر من القيمة المحدّدة.

المعلمات

الاسم	النوع	الوصف
number	Number	القيمة التي يجب أن تكون أكبر من العنصر

الإرجاع

TextValidationBuilder — هذا TextValidation، لإنشاء سلسلة

---

requireNumberGreaterThanOrEqualTo(number)

تتطلّب هذه السمة أن يكون العنصر النصي رقمًا أكبر من أو يساوي القيمة المحدّدة.

المعلمات

الاسم	النوع	الوصف
number	Number	القيمة التي يجب أن تكون السمة أكبر منها أو مساوية لها

الإرجاع

TextValidationBuilder — هذا TextValidation، لإنشاء سلسلة

---

requireNumberLessThan(number)

تتطلّب هذه السمة أن يكون العنصر النصي رقمًا أقل من القيمة المحدّدة.

المعلمات

الاسم	النوع	الوصف
number	Number	القيمة التي يجب أن تكون أكبر من العنصر

الإرجاع

TextValidationBuilder — هذا TextValidation، لإنشاء سلسلة

---

requireNumberLessThanOrEqualTo(number)

تتطلّب هذه السمة أن يكون العنصر النصي رقمًا أقل من أو يساوي القيمة المحدّدة.

المعلمات

الاسم	النوع	الوصف
number	Number	القيمة التي يجب أن تكون العنصر أقل منها أو مساوية لها

الإرجاع

TextValidationBuilder — هذا TextValidation، لإنشاء سلسلة

---

requireNumberNotBetween(start, end)

تتطلّب هذه السمة أن يكون العنصر النصي رقمًا لا يقع بين البدء والنهاية.

المعلمات

الاسم	النوع	الوصف
start	Number	الحدود الدنيا للنطاق الشامل
end	Number	الحدود العليا للنطاق الشامل

الإرجاع

TextValidationBuilder — هذا TextValidation، لإنشاء سلسلة

---

requireNumberNotEqualTo(number)

يتطلّب هذا الشرط أن يكون العنصر النصي رقمًا لا يساوي القيمة المحدّدة.

المعلمات

الاسم	النوع	الوصف
number	Number	القيمة التي يجب ألا يساويها العنصر

الإرجاع

TextValidationBuilder — هذا TextValidation، لإنشاء سلسلة

---

requireTextContainsPattern(pattern)

يجب أن يحتوي الردّ على نمط.

المعلمات

الاسم	النوع	الوصف
pattern	String	يجب أن يحتوي النص على النمط

الإرجاع

TextValidationBuilder — هذا للربط

---

requireTextDoesNotContainPattern(pattern)

يجب ألا يحتوي الردّ على نمط.

المعلمات

الاسم	النوع	الوصف
pattern	String	يجب ألا يحتوي النص على نمط.

الإرجاع

TextValidationBuilder — هذا للربط

---

requireTextDoesNotMatchPattern(pattern)

يجب أن لا تتطابق الإجابة مع النمط.

المعلمات

الاسم	النوع	الوصف
pattern	String	يجب ألا يتطابق النص مع النمط.

الإرجاع

TextValidationBuilder — هذا للربط

---

requireTextIsEmail()

يتطلب أن يكون العنصر النصي عنوان بريد إلكتروني.

الإرجاع

TextValidationBuilder — هذا TextValidation، لإنشاء سلسلة

---

requireTextIsUrl()

تتطلّب أن يكون العنصر النصي عنوان URL.

الإرجاع

TextValidationBuilder — هذا TextValidation، لإنشاء سلسلة

---

requireTextLengthGreaterThanOrEqualTo(number)

تتطلّب هذه السمة أن يكون طول الاستجابة أكبر من القيمة أو يساويها.

المعلمات

الاسم	النوع	الوصف
number	Integer	يجب أن يكون طول نص الفقرة أكبر من هذه القيمة.

الإرجاع

TextValidationBuilder — هذا للربط

---

requireTextLengthLessThanOrEqualTo(number)

تتطلّب هذه السمة أن يكون طول الاستجابة أقل من القيمة.

المعلمات

الاسم	النوع	الوصف
number	Integer	يجب أن يكون طول نص الفقرة أقل من أو يساوي هذه القيمة.

الإرجاع

TextValidationBuilder — هذا للربط

---

requireTextMatchesPattern(pattern)

يجب أن تتطابق الإجابة مع النمط.

المعلمات

الاسم	النوع	الوصف
pattern	String	يجب أن يتطابق النص مع النمط

الإرجاع

TextValidationBuilder — هذا للربط

---

requireWholeNumber()

يتطلب هذا الحقل أن يكون العنصر النصي عددًا صحيحًا.

الإرجاع

TextValidationBuilder — هذا TextValidation، لإنشاء سلسلة