Class TextValidationBuilder

TextValidationBuilder

用于 TextValidation 的 DataValidationBuilder。

// 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	要求文本项为介于 start 和 end 之间的数字（含 start 和 end）。
requireNumberEqualTo(number)	TextValidationBuilder	要求文本项为等于指定值的数字。
requireNumberGreaterThan(number)	TextValidationBuilder	要求文本项为大于指定值的数字。
requireNumberGreaterThanOrEqualTo(number)	TextValidationBuilder	要求文本项为大于或等于指定值的数字。
requireNumberLessThan(number)	TextValidationBuilder	要求文本项为小于指定值的数字。
requireNumberLessThanOrEqualTo(number)	TextValidationBuilder	要求文本项为小于或等于指定值的数字。
requireNumberNotBetween(start, end)	TextValidationBuilder	要求文本项为不介于 start 和 end 之间的数字（含 start 和 end）。
requireNumberNotEqualTo(number)	TextValidationBuilder	要求文本项为不等于指定值的数字。
requireTextContainsPattern(pattern)	TextValidationBuilder	要求响应包含模式。
requireTextDoesNotContainPattern(pattern)	TextValidationBuilder	要求响应不包含模式。
requireTextDoesNotMatchPattern(pattern)	TextValidationBuilder	要求响应与模式不匹配。
requireTextIsEmail()	TextValidationBuilder	要求文本项为电子邮件地址。
requireTextIsUrl()	TextValidationBuilder	要求文本项为网址。
requireTextLengthGreaterThanOrEqualTo(number)	TextValidationBuilder	要求响应长度大于或等于值。
requireTextLengthLessThanOrEqualTo(number)	TextValidationBuilder	要求响应长度小于值。
requireTextMatchesPattern(pattern)	TextValidationBuilder	要求响应与模式匹配。
requireWholeNumber()	TextValidationBuilder	要求文本项为整数。

详细文档

requireNumber()

要求文本项为数字。

返回

TextValidationBuilder - 此 TextValidation，用于链式调用

---

requireNumberBetween(start, end)

要求文本项为介于 start 和 end 之间的数字（含 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 和 end 之间的数字（含 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()

要求文本项为网址。

返回

TextValidationBuilder - 此 TextValidation，用于链式调用

---

requireTextLengthGreaterThanOrEqualTo(number)

要求响应长度大于或等于值。

参数

名称	类型	说明
number	Integer	段落文本长度必须大于此值

返回

TextValidationBuilder - 此项用于链式调用

---

requireTextLengthLessThanOrEqualTo(number)

要求响应长度小于值。

参数

名称	类型	说明
number	Integer	段落文本长度必须小于或等于此值

返回

TextValidationBuilder - 此项用于链式调用

---

requireTextMatchesPattern(pattern)

要求响应与模式匹配。

参数

名称	类型	说明
pattern	String	文本必须与模式匹配

返回

TextValidationBuilder - 此项用于链式调用

---

requireWholeNumber()

要求文本项为整数。

返回

TextValidationBuilder - 此 TextValidation，用于链式调用