高级问题类型

法律条款

要求受访者接受或拒绝的条款和条件接受问题，呈现一段声明文本。

类型标识符：legal

属性

行为

• 显示 buttonText 中的法律文本。
• 受访者点击"我接受"或"我不接受"。
• 通常用于隐私政策、服务条款、同意书和数据处理协议。

验证

如果 required 为 true，受访者必须接受条款才能继续。当问题为必填时，拒绝（选择"我不接受"）将显示验证错误。

逻辑跳转运算符

equals、not_equals、is_answered、is_not_answered

使用 equals 时，与 true（接受）或 false（拒绝）比较。

答案格式

答案存储为布尔值（true 表示接受，false 表示拒绝，未回答时为 null）。

测验模式评分

法律条款是可评分的问题类型：

• 知识测验：设置 correctAnswers，值为 "true" 或 "false"。
• 潜客评估：设置 choiceScores，键为 "true" 和 "false"。
• 匹配测验：设置 choiceOutcomes，将接受/拒绝映射到结束页面。

支付

作为表单流程的一部分，使用 Stripe 集成向受访者收取付款。支持两种支付模式、可配置的货币和固定或可变金额。

类型标识符：payment

支付模式

属性

行为

• 如果设置了 price，受访者看到固定金额并提供卡片详情。
• 如果未设置 price，受访者输入自己的金额（可变/捐赠模式）。
• 渲染 Stripe Payment Element 以安全收集卡片信息。
• 支付成功后，表单自动前进到下一个问题。

验证

如果 required 为 true，受访者必须完成支付才能继续。

逻辑跳转运算符

equals、not_equals、is_answered、is_not_answered

答案格式

答案存储为 PaymentResult 对象：

{
  "paymentIntentId": "pi_abc123",
  "amount": 2999,
  "currency": "usd",
  "status": "succeeded"
}

日期

允许受访者选择日期的日期选择器。支持可配置的日期格式。

类型标识符：date

属性

行为

• 显示日期选择器界面。
• 受访者可以手动输入日期或从日历小部件中选择。
• 无论显示格式如何，日期以 ISO 格式存储。

验证

如果 required 为 true，受访者必须选择日期。

逻辑跳转运算符

equals、not_equals、is_answered、is_not_answered

答案格式

答案存储为字符串（日期值，通常为 ISO 格式或配置的 dateFormat）。

排序

向受访者展示一组项目，通过拖拽操作按偏好顺序排列。

类型标识符：ranking

属性

行为

• 项目以列表形式显示。
• 受访者拖拽项目重新排列。
• 拖拽手柄标示可拖拽的项目。
• 同时支持触摸和鼠标交互。

验证

如果 required 为 true，受访者必须提交排序结果。

逻辑跳转运算符

equals、not_equals、is_answered、is_not_answered

答案格式

答案存储为字符串数组（按受访者排列顺序的选项 ID）。

矩阵

基于网格的问题类型，受访者对多个项目在多个类别中进行评价。

类型标识符：matrix

属性

行为

• 显示为左侧为行、顶部为列的网格。
• 受访者为每行选择一个选项。
• 在移动设备上，网格适配为堆叠格式以提高可用性。

验证

如果 required 为 true，受访者必须为每一行选择一个选项。

逻辑跳转运算符

equals、not_equals、is_answered、is_not_answered

答案格式

答案存储为对象，将行标签映射到所选的列标签：

{
  "Quality": "Excellent",
  "Speed": "Good",
  "Support": "Average"
}

联系信息

在单个问题中收集结构化的联系信息，包括姓名、电子邮件地址和电话号码。

类型标识符：contact_info

属性

行为

• 显示名字、姓氏、电子邮件和电话号码字段。
• 电话字段包含国家代码选择器。
• 每个子字段可以单独设置为必填或可选。

验证

如果 required 为 true，所有可见的子字段都必须填写。

逻辑跳转运算符

equals、not_equals、is_answered、is_not_answered

答案格式

答案存储为对象：

{
  "firstName": "Jane",
  "lastName": "Smith",
  "email": "jane@example.com",
  "phone": "+14155551234"
}

地址

收集完整的邮寄地址，带可选的 Google Places 自动补全功能。

类型标识符：address

属性

行为

• 显示街道地址、城市、州/省、邮政编码和国家字段。
• 启用自动补全后，在街道字段中输入会显示地址建议。
• 选择建议会自动填充所有地址字段。

验证

如果 required 为 true，所有地址字段都必须填写。

逻辑跳转运算符

equals、not_equals、is_answered、is_not_answered

答案格式

答案存储为对象：

{
  "street": "123 Main St",
  "city": "San Francisco",
  "state": "CA",
  "postalCode": "94105",
  "country": "US"
}

数据节点

在表单流程中进行 HTTP API 调用的不可见问题类型。数据节点不会渲染给受访者——它们自动执行，可以获取数据、验证答案或触发外部操作。

类型标识符：data_node

属性

行为

• 在表单流程中到达时自动执行。
• URL、请求头和请求体中的所有 {variableName} 标记被替换为当前变量值。
• 如果设置了 dataNodeResponseVariable，完整的 JSON 响应将作为表单变量存储。
• 在静默模式下，请求在后台触发，无加载指示器。
• 在验证网关模式下，请求失败会阻止从上一个问题继续前进。

用例

• 获取外部数据：在表单流程中查找产品详情、定价或用户资料。
• 验证答案：根据数据库检查电子邮件、验证优惠码或验证地址。
• 触发操作：向 webhook 发送数据、在 CRM 中创建记录或启动工作流程。

通用高级功能

标题和描述中的富文本

所有高级问题类型在标题和描述字段中支持富文本。富文本通过表单构建器中基于 Tiptap 的编辑器输入，支持：

• 粗体、斜体、下划线和删除线
• 链接（带 href、target、rel 属性）
• 有序和无序列表
• 内联代码
• 上标和下标
• 通过内联样式自定义字体系列和颜色

富文本以 HTML 存储，渲染前使用 DOMPurify 和严格的标签及属性白名单进行净化。

变量替换

所有高级问题类型在标题和描述字段中支持 {variableName} 替换。请参阅变量指南。

媒体附件

所有高级问题类型支持媒体附件（图片、视频、图标、二维码），提供全套布局选项。请参阅创建表单指南。