留资玩法

>该功能主要适用于需要收集用户信息的场景，支持表单中的级联选择。可以根据接口动态加载级联数据，并支持透传参数。此外，还提供了自动填充数据的功能，方便用户填写表单。
## 应用案例
**基于定位的最近经销商推荐留资表单**

通过在留资表单中根据访客的定位信息推荐最近的经销商列表，并选择其中一个经销商后提交表单。业务场景是在小程序中嵌入H5活动，小程序已经实现了访客的定位功能（获取经纬度），并在通过webview打开H5活动时将经纬度参数附加在链接上。留资表单在请求客户提供的“查询经销商列表”接口时，会携带经纬度参数以便匹配查询。

## 制作流程
选择留资玩法，会生成一个留资按钮组件和对应的留资表单详情页，访客端点击留资按钮组件，留资表单详情页会以弹窗的形式弹出，用户可在留资表单详情页填写信息提交
1. 创建一个H5活动并选择留资组件玩法
![](/media/202407/2024-07-04_104223_4188640.2327211149757883.png)

2. 编辑留资组件
![](/media/202407/2024-07-04_104307_3762310.5368785235707917.png)

3. 切换到留资表单详情页编辑
![](/media/202407/2024-07-04_104353_7257520.19367919455015248.png)

4. 编辑组件设置
![](/media/202407/2024-07-04_104452_6040840.0554412863318986.png)
- 输入来源。分为手动输入和接口获取：
	- 手动输入，即用户自己填写信息，系统默认。
	- 接口获取，无需选择具体接口，默认使用访客授权返回的用户信息相关的字段，需要访客授权后才可以获取到数据。
- 输入时机。
	- 打开页面授权输入。授权接口获取到用户信息之后自动填充值到输入框。
	- 一键获取时输入。留资详情页面会生成一个一键获取按钮组件，点击按钮填充用户信息到输入框。
- key。内置了“手机号”和“昵称”，选择后会将数据填充到对应组件。
- 接口获取后允许修改。表示输入框填充值之后用户可以继续编辑，否就是不允许用户编辑。
- 手机号验证。点击后会将电话输入框组件转换为短信验证码组件，注意短信验证码组件在访客端必填短信验证码才可提交。

## 接口规范
通过接口渲染下拉组件数据和级联选择，参照文档 [自定义下拉表单组件](https://hc.eqxiu.cn/doc/66/)
![](/media/202407/2024-07-04_105404_0574550.9415890629968138.png)