> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用输入字段收集数据

> 使用文本、邮箱、电话、邮政编码、下拉菜单、日期和滑块等输入字段在测验漏斗中收集访客数据，并设置字段名称、占位文字和校验规则。

输入字段让你可以在测验或流程中**收集访客的数据**。它们用于获取姓名、邮箱、电话号码以及其他结构化信息。

## 可用的输入类型

LanderLab 根据你想收集的数据类型，提供多种输入字段：

| 输入类型 | 说明 |
| :- | :- |
| **Text Field** | 短文本（例如名字） |
| **Long Text** | 较长的回答或描述 |
| **Email** | 校验邮箱格式 |
| **Phone Number** | 收集带国家代码的电话号码 |
| **Number** | 仅限数字输入 |
| **Select** | 带预设选项的下拉菜单 |
| **Checkbox** | 是/否或同意类输入 |
| **Google Address** | 地址自动补全输入 |
| **Zip Code** | 带校验的邮政编码输入 |
| **Date Picker** | 从日历中选择日期 |
| **Date of Birth / Birthdate Picker** | 专用的日期输入 |
| **Range Slider** | 通过滑块选择数值 |
| **OTP** | 一次性密码验证 |
| **Hidden Field** | 存储不可见的数据（UTM、ID 等） |

## 通用设置（所有输入字段）

大多数输入字段共享相同的核心设置。

### General（常规）

* **Name** → 内部字段名称
  * 用于变量（例如 `{{email}}`）
  * 发送到你的 CRM
  * 必须**在整个流程中唯一**
* **Label** → 显示在字段上方的可见标题
  * 示例：*邮箱地址*
* **Placeholder** → 输入框内的提示文字
  * 示例：[*example@email.com*](mailto:example@email.com)

### Validation（校验）

校验可确保用户在继续之前输入**正确且必填的数据**。

* 要求必须填写字段
* 强制使用正确的格式（邮箱、数字等）

### Decorators（装饰项）

为输入框添加额外元素：

* **Prefix** → 输入框前的文字/图标（例如 `$`、📞）
* **Suffix** → 输入框后的文字/图标（例如 `%`、kg）
* **Help Text** → 简短的引导文字或工具提示

### Spacing（间距）

控制布局和位置：

* **Size** → S、M、L、Full width
* **Margin** → 调整字段周围的间距

### Appearance（外观）

* **Visibility** → 在桌面端、移动端或两者上显示

## 专用输入字段

部分输入字段会根据用途提供额外设置。

### Range Slider

用于选择预算、评分或数量等数值。

* **Min / Max / Step** → 定义范围和增量
* **Initial Value** → 默认位置
* **Prefix / Suffix** → 添加单位（例如 \$、%、kg）
* **Thousands Separator** → 格式化较大的数字

### Zip Code

针对基于地理位置的输入进行了优化。

* **Country** → 决定校验格式
* 支持不同的 ZIP/邮政编码格式

### Checkbox

用于确认或同意。

* 适用于：
  * 条款与条件
  * 同意勾选框
* 支持带格式的文本和链接

### Select（下拉菜单）

让用户从预设选项中进行选择。

* **Options**：
  * Display Name（用户看到的内容）
  * Value（发送到 CRM 的内容）

其他控制项：

* 按字母顺序排序
* 倒序排列
* 随机排列选项

### Phone Number

专为收集电话号码而设计，支持国家代码处理。

* **Default Country Code**
* 可选择允许用户选择国家
* 可选择在存储值中包含完整号码

### Date Field

用于通过日历选择日期。

* **Date Format**
* 限制：
  * 未来日期
  * 过去日期
  * 仅限工作日
* 可选择将周一设为一周的第一天

## 最佳实践

* 保持输入字段**简洁精简**，以减少流失
* 使用**占位文字和帮助文本**引导用户
* 确保字段名称**唯一且一致**，便于 CRM 字段映射
* 使用专用输入字段（如 Phone 或 Zip Code）以获得更好的校验效果


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.