文本输入问题类型

短文本

用于收集简短回答（如姓名、标题或简短答案）的单行文本输入。

类型标识符：short_text

属性

属性	类型	描述	默认值
`placeholder`	string	受访者输入前显示在输入框中的占位符文本。	无
`maxLength`	number	允许的最大字符数。	无（无限制）
`minLength`	number	要求的最少字符数。	无

验证

规则	描述
`minLength`	回答必须至少包含此数量的字符。
`maxLength`	回答不能超过此数量的字符。
`pattern`	回答必须匹配的正则表达式。
`customMessage`	验证失败时的自定义错误消息。

逻辑跳转运算符

equals、not_equals、contains、not_contains、is_answered、is_not_answered

答案格式

答案存储为字符串。

长文本

用于收集较长回答（如反馈、描述或段落）的多行文本区域。

类型标识符：long_text

属性

属性	类型	描述	默认值
`placeholder`	string	显示在文本区域中的占位符文本。	无
`maxLength`	number	允许的最大字符数。	无（无限制）
`minLength`	number	要求的最少字符数。	无

验证

规则	描述
`minLength`	回答必须至少包含此数量的字符。
`maxLength`	回答不能超过此数量的字符。
`pattern`	回答必须匹配的正则表达式。
`customMessage`	验证失败时的自定义错误消息。

逻辑跳转运算符

equals、not_equals、contains、not_contains、is_answered、is_not_answered

答案格式

答案存储为字符串。

长文本字段随着受访者输入而垂直扩展。与短文本字段不同，它们支持多行输入，受访者可以使用 Shift+Enter 创建新行。

电子邮件

带有内置格式验证的电子邮件地址字段。

类型标识符：email

属性

属性	类型	描述	默认值
`placeholder`	string	输入框中显示的占位符文本。	无

验证

电子邮件字段自动验证输入是否匹配标准电子邮件格式（例如 user@domain.com）。可以添加额外的验证规则：

规则	描述
`pattern`	用于额外验证的自定义正则表达式。
`customMessage`	验证失败时的自定义错误消息。

逻辑跳转运算符

equals、not_equals、contains、not_contains、is_answered、is_not_answered

答案格式

答案存储为字符串（电子邮件地址）。

电话号码

支持国际区号的电话号码字段。

类型标识符：phone

属性

属性	类型	描述	默认值
`placeholder`	string	输入框中显示的占位符文本。	无
`defaultCountryCode`	string	默认预选的国家代码（例如 `"US"`、`"GB"`、`"DE"`）。	无

验证

内置电话号码验证。该字段接受国际电话号码格式。

逻辑跳转运算符

equals、not_equals、contains、not_contains、is_answered、is_not_answered

答案格式

答案存储为字符串（包含国家区号的完整电话号码）。

电话字段包含国家代码选择器下拉菜单。设置 defaultCountryCode 后，下拉菜单会预选该国家并显示其拨号代码。

数字

用于收集数字的数值输入字段，带可选的最小/最大范围验证。

类型标识符：number

属性

属性	类型	描述	默认值
`placeholder`	string	输入框中显示的占位符文本。	无
`min`	number	允许的最小值。	无
`max`	number	允许的最大值。	无

验证

规则	描述
`min`	数字必须大于或等于此值。
`max`	数字必须小于或等于此值。
`customMessage`	验证失败时的自定义错误消息。

逻辑跳转运算符

equals、not_equals、greater_than、less_than、greater_than_or_equals、less_than_or_equals、is_answered、is_not_answered

答案格式

答案存储为数字（未回答时为 null）。

测验模式

在测验模式中，数字问题类型不可评分——它不参与自动评分。

网站 / URL

用于收集网址的 URL 字段。NueForm 将 url 和 website 类型视为相同。

类型标识符：url 或 website

属性

属性	类型	描述	默认值
`placeholder`	string	输入框中显示的占位符文本。	无

验证

该字段验证输入是否为格式正确的 URL。

逻辑跳转运算符

equals、not_equals、contains、not_contains、is_answered、is_not_answered

答案格式

答案存储为字符串（URL）。

联系信息

在单个问题中收集受访者姓名、电子邮件地址和电话号码的复合字段。这是一种便捷类型，将多个文本输入组合为一个表单步骤。

类型标识符：contact_info

属性

属性	类型	描述	默认值
`defaultCountryCode`	string	电话号码子字段的默认国家代码。	无
`fields`	FormQuestion[]	可选的自定义子字段定义。如果提供，将覆盖默认的姓名/电子邮件/电话字段。	默认子字段

子字段

联系信息问题默认包含三个子字段：

姓名 -- 短文本字段。
电子邮件 -- 带格式验证的电子邮件字段。
电话 -- 支持国家区号的电话号码字段。

联系信息问题的问题编号前缀是隐藏的，因为它们同时显示多个输入字段。

答案格式

答案存储为对象（Record<string, string>），包含每个子字段的键：

json

{
  "name": "John Smith",
  "email": "john@example.com",
  "phone": "+1 555-0123"
}

地址

带可选 Google Places 自动补全的完整邮寄地址字段。

类型标识符：address

属性

属性	类型	描述	默认值
`enableAddressAutocomplete`	boolean	启用 Google Places 自动补全，帮助受访者快速填写地址。	禁用
`fields`	FormQuestion[]	可选的自定义子字段定义。如果提供，将覆盖默认地址字段。	默认子字段

子字段

地址问题包含以下子字段：

街道地址 -- 街道地址行。
城市 -- 城市或地区。
州/省 -- 州、省或地区。
邮政编码 -- 邮政编码或 ZIP 代码。
国家 -- 国家。

地址自动补全

启用 enableAddressAutocomplete 后，受访者可以开始输入地址并看到 Google Places 的建议。选择建议会自动填充所有地址子字段。

地址自动补全需要在您的 NueForm 账户设置中配置 Google Maps API 密钥。地址问题的问题编号前缀是隐藏的。

答案格式

答案存储为对象（Record<string, string>），包含每个子字段的键：

json

{
  "street": "123 Main Street",
  "city": "San Francisco",
  "state": "CA",
  "zip": "94105",
  "country": "United States"
}

媒体附件

所有文本输入问题类型都支持媒体附件。您可以为任何文本问题添加图片、视频、图标或二维码。有关媒体选项和布局配置的详情，请参阅创建表单指南。