普通表单
未升级到新版信息架构的组织,请 点此查看 使用手册
1.简介
1.1功能简介
可以收集业务进展中的所有数据,收集上来的数据还可以进行分权协作,将数据权限 发布 给需要管理数据的成员或者发布给外部成员进行外部数据收集
1.2使用场景
普通表单无审批流程,可以在调查统计、在线报名、销售上报、会议预约、采购入库、订单录入、扫码签到等场景使用
2. 普通表单属性设置
2.1 PC 端设置
列数指当前表单上的组件呈现 1 列或者 2 列
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638942021611-9a16e721-b137-4953-ac54-e89478492722.png)
电脑端设置列数
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638942072791-b84ee49d-7a56-4773-89ff-0494d6c23618.png)
2.2 表单校验
详情可查看文档:表单校验
2.3 表单事件
详情可查看文档:表单业务规则
3. 普通表单高级属性设置
路径:表单 >> 点击空白处 >> 属性 >> 高级,效果如图:
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638942211902-51c34da1-3e6e-4d9d-97ed-1c9af9626cf2.png)
高级设置
3.1 提交文案
修改提交按钮的显示文字,支持国际化和变量绑定,效果如图:
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638942246829-46b3e237-9aa6-45e1-8768-0b7868ad384b.png)
可自行修改提交按钮
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638942323877-676e304a-5b64-41f2-b069-042ec454aa9e.png)
3.2 表单提交前
默认情况下,表单数据在校验和设置完成后,会提交给宜搭的后端接口,将表单数据保存。
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638942741518-04324f8c-87c4-439d-8d19-861377e00550.png)
动作绑定
表单提交前选项提供了阻止表单默认的提交行为的能力,通过在动作中判断并返回 false,可阻止并自定义后续的的行为。
export function beforeSubmit({ formDataMap }){
// 注意:目前不支持在这里修改提交数据
console.log('beforeSubmit', formDataMap);
// 需要时可返回 false 阻止提交,支持 Promise
// return false;
}
也可以返回 Promise
做一些异步的判断逻辑:
export function beforeSubmit({ formDataMap }){
// 注意:目前不支持在这里修改提交数据
return new Promise((resolve) => {
// 如请求数据源
this.dataSourceMap.someRequest.load().then((res) => {
if (res) {
// 通过返回 false 阻止提交
resolve(false);
} else {
resolve();
}
});
});
}
提示:如果返回了 Promise
,按钮的加载中状态会等待 Promise
返回。
注:目前不支持在该动作中修改提交数据
3.3 表单提交后
默认情况下,宜搭的表单会在提交后跳转,具体跳转地址可能为提示成功页(PC 端)、详情页(移动端),或用户设置的指定页面(表单设置)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638942773171-14a53d5d-9585-4aa8-a351-7ecaa1c57d6f.png)
表单提交后选项提供了阻止表单默认的跳转行为的能力,通过在动作中判断并返回 false,可阻止并自定义后续的的行为。
export function afterSubmit({ submitResult }){
console.log('afterSubmit', submitResult);
// 需要时可返回 false 阻止后续操作,支持 Promise
// return false;
}
也可以返回 Promise
做一些异步的判断逻辑:
export function afterSubmit({ submitResult }){
return new Promise((resolve) => {
// 如请求数据源
this.dataSourceMap.someRequest.load().then((res) => {
if (res) {
// 通过返回 false 阻止后续操作
resolve(false);
} else {
resolve();
}
});
});
}
提示:如果返回了 Promise
,按钮的加载中状态会等待 Promise
返回。
3.4 表单数据源
表单数据源提供了一个整体控制表单值的方式,目前有两种用途:
- 提供初始值,即表单内各个字段的默认值;
- 修改表单数据源时,对应表单字段的值也会同步修改。
如在表单数据源中指定某个字段的值(可直接复制使用):
{
"textField_km1nnpxu": "测试单行文本的值"
}
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638944007631-106e301a-d026-4cbe-b1b6-0e34ebb34a67.png)
----获取宜搭最新信息,欢迎关注我们----
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/jpeg/1632807780139-91cbcd43-8c42-44f3-9b2d-0d8b799ab7ea.jpeg)
本文档对您是否有帮助?