普通表單

1.簡介

1.1功能簡介

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

1.2使用場景

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

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

2.1 PC 端設(shè)置

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

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

2.2 表單校驗

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

2.3 表單事件

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

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

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

高級設(shè)置

3.1 提交文案

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

可自行修改提交按鈕

3.2 表單提交前

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

動作綁定

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

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

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

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

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

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

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

3.3 表單提交后

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

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

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

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

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

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

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

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

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

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

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

{
  "textField_km1nnpxu": "測試單行文本的值"
}