1.簡(jiǎn)介

1.1功能簡(jiǎn)介

可以收集業(yè)務(wù)進(jìn)展中的所有數(shù)據(jù)，收集上來(lái)的數(shù)據(jù)還可以進(jìn)行分權(quán)協(xié)作，將數(shù)據(jù)權(quán)限 發(fā)布 給需要管理數(shù)據(jù)的成員或者發(fā)布給外部成員進(jìn)行外部數(shù)據(jù)收集

1.2使用場(chǎng)景

普通表單無(wú)審批流程，可以在調(diào)查統(tǒng)計(jì)、在線報(bào)名、銷售上報(bào)、會(huì)議預(yù)約、采購(gòu)入庫(kù)、訂單錄入、掃碼簽到等場(chǎng)景使用

2. 普通表單屬性設(shè)置

2.1 PC 端設(shè)置

列數(shù)指當(dāng)前表單上的組件呈現(xiàn) 1 列或者 2 列

電腦端設(shè)置列數(shù)

2.2 表單校驗(yàn)

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

2.3 表單事件

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

3. 普通表單高級(jí)屬性設(shè)置

路徑：表單 >> 點(diǎn)擊空白處 >> 屬性 >> 高級(jí)，效果如圖：

高級(jí)設(shè)置

3.1 提交文案

修改提交按鈕的顯示文字，支持國(guó)際化和變量綁定，效果如圖：

可自行修改提交按鈕

3.2 表單提交前

默認(rèn)情況下，表單數(shù)據(jù)在校驗(yàn)和設(shè)置完成后，會(huì)提交給宜搭的后端接口，將表單數(shù)據(jù)保存。

動(dòng)作綁定

表單提交前選項(xiàng)提供了阻止表單默認(rèn)的提交行為的能力，通過(guò)在動(dòng)作中判斷并返回 false，可阻止并自定義后續(xù)的的行為。

export function beforeSubmit({ formDataMap }){
  // 注意：目前不支持在這里修改提交數(shù)據(jù)
  
  console.log('beforeSubmit', formDataMap);

  // 需要時(shí)可返回 false 阻止提交，支持 Promise
  // return false;
}

也可以返回 Promise 做一些異步的判斷邏輯：

export function beforeSubmit({ formDataMap }){
  // 注意：目前不支持在這里修改提交數(shù)據(jù)
  return new Promise((resolve) => {
  	// 如請(qǐng)求數(shù)據(jù)源
    this.dataSourceMap.someRequest.load().then((res) => {
      if (res) {
        // 通過(guò)返回 false 阻止提交
        resolve(false);
      } else {
        resolve();
      }
    });
  });
}

提示：如果返回了 Promise ，按鈕的加載中狀態(tài)會(huì)等待 Promise 返回。

注：目前不支持在該動(dòng)作中修改提交數(shù)據(jù)

3.3 表單提交后

默認(rèn)情況下，宜搭的表單會(huì)在提交后跳轉(zhuǎn)，具體跳轉(zhuǎn)地址可能為提示成功頁(yè)（PC 端）、詳情頁(yè)（移動(dòng)端），或用戶設(shè)置的指定頁(yè)面（表單設(shè)置）

表單提交后選項(xiàng)提供了阻止表單默認(rèn)的跳轉(zhuǎn)行為的能力，通過(guò)在動(dòng)作中判斷并返回 false，可阻止并自定義后續(xù)的的行為。

export function afterSubmit({ submitResult }){
  console.log('afterSubmit', submitResult);

  // 需要時(shí)可返回 false 阻止后續(xù)操作，支持 Promise
  // return false;
}

也可以返回 Promise 做一些異步的判斷邏輯：

export function afterSubmit({ submitResult }){
  return new Promise((resolve) => {
  	// 如請(qǐng)求數(shù)據(jù)源
    this.dataSourceMap.someRequest.load().then((res) => {
      if (res) {
        // 通過(guò)返回 false 阻止后續(xù)操作
        resolve(false);
      } else {
        resolve();
      }
    });
  });
}

提示：如果返回了 Promise ，按鈕的加載中狀態(tài)會(huì)等待 Promise 返回。

3.4 表單數(shù)據(jù)源

表單數(shù)據(jù)源提供了一個(gè)整體控制表單值的方式，目前有兩種用途：

• 提供初始值，即表單內(nèi)各個(gè)字段的默認(rèn)值；
• 修改表單數(shù)據(jù)源時(shí)，對(duì)應(yīng)表單字段的值也會(huì)同步修改。

如在表單數(shù)據(jù)源中指定某個(gè)字段的值（可直接復(fù)制使用）：

{
  "textField_km1nnpxu": "測(cè)試單行文本的值"
}