Class TextValidationBuilder

TextValidationBuilder

أداة DataValidationBuilder لـ TextValidation.

// Add a text item to a form and require it to be a number within a range.
var textItem = form.addTextItem().setTitle('Pick a number between 1 and 100?');
var 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 هذا، للسلسلة