普通表单

1.简介

1.1功能简介

可以收集业务进展中的所有数据，收集上来的数据还可以进行分权协作，将数据权限 发布 给需要管理数据的成员或者发布给外部成员进行外部数据收集

1.2使用场景

普通表单无审批流程，可以在调查统计、在线报名、销售上报、会议预约、采购入库、订单录入、扫码签到等场景使用

2. 普通表单属性设置

2.1 PC 端设置

列数指当前表单上的组件呈现 1 列或者 2 列

电脑端设置列数

2.2 表单校验

详情可查看文档：https://www.yuque.com/yida/support/un1t9v

2.3 表单事件

详情可查看文档：https://www.yuque.com/yida/support/dssg6y

3. 普通表单高级属性设置

路径：表单 >> 点击空白处 >> 属性 >> 高级，效果如图：

高级设置

3.1 提交文案

修改提交按钮的显示文字，支持国际化和变量绑定，效果如图：

可自行修改提交按钮

3.2 表单提交前

默认情况下，表单数据在校验和设置完成后，会提交给宜搭的后端接口，将表单数据保存。

动作绑定

表单提交前选项提供了阻止表单默认的提交行为的能力，通过在动作中判断并返回 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 端）、详情页（移动端），或用户设置的指定页面（表单设置）

表单提交后选项提供了阻止表单默认的跳转行为的能力，通过在动作中判断并返回 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": "测试单行文本的值"
}