Class TextValidationBuilder

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، للسلاسل