DIV CSS 佈局教程網

EasyUI 表單提交完整範例:驗證、進度提示與視窗收尾
編輯:JavaScript綜合知識     

用 EasyUI 的 form 方法做 AJAX 表單提交,比傳統的頁面跳轉多了幾個環節:送出前驗證、送出中提示、成功後刷新列表並關閉視窗、失敗時顯示原因。以下是一段可直接參考的結構。

程式碼

$('#form').form({
  url: 'test/add.do',
  onSubmit: function () {
    parent.$.messager.progress({
      title: '提示',
      text : '數據處理中,請稍後....'
    });

    var gridValid = endEdit();        // 子表結束編輯並驗證
    if (!gridValid) {
      parent.$.messager.progress('close');
      return false;                   // 回傳 false 可中止送出
    }

    var isValid = $('#form').form('validate');
    if (!isValid) {
      parent.$.messager.progress('close');
      return false;
    }

    accept();                         // 把子表增刪改的資料寫進隱藏 input
    return true;
  },

  success: function (result) {
    parent.$.messager.progress('close');
    try {
      var data = eval("(" + result + ")");     // JSON 字串轉物件
      if (data && data.success) {
        if (data.msg && data.msg != "")
          parent.$.messager.alert('提示', data.msg);
        else
          parent.$.messager.alert('提示', "添加成功");

        parent.$.modalDialog.openner_grid.datagrid('reload');   // 刷新列表
        parent.$.modalDialog.handler.dialog('close');           // 關閉目前視窗
      } else {
        parent.$.messager.alert('錯誤', data.msg);
      }
    } catch (e) {
      parent.$.errorDialog(result);   // 伺服器回傳非 JSON,視為異常
    }
  }
});

四個環節的意義

onSubmit 回傳 false 即中止。這是 EasyUI 的設計:表單會在送出前呼叫 onSubmit,若回傳 false 就不發請求。因此所有前置檢查都放在這裡,任一項失敗就關掉進度提示並回傳 false。

進度提示要記得關。程式中每個 return false 之前都呼叫了 progress('close')。若漏掉,遮罩會永遠卡在畫面上,使用者只能重新整理。這是最常見的疏失。

success 中必須 try/catch。eval 解析字串時,若伺服器因例外而回傳 HTML 錯誤頁,就會拋出語法錯誤。用 try/catch 攔下並導向錯誤提示,能避免「按了沒反應」的窘境。

成功後 reload 列表並關閉視窗。順序上先刷新再關閉比較安全——若顛倒,reload 可能作用在一個已被移除的 grid 上。

務必替換的兩個寫法

eval 應改為 JSON.parse。eval("(" + result + ")") 是早期為相容舊瀏覽器而生的寫法,但它會執行字串中的任意程式碼。伺服器回傳的內容一旦被污染,就是一個 XSS 入口。請直接改用:

var data = JSON.parse(result);

回傳格式要約定好。建議後端在錯誤時也回傳 JSON(例如 {"success": false, "msg": "..."}),並設定適當的 HTTP 狀態碼;如此前端就不必靠「解析失敗」來推測發生了什麼,錯誤處理會乾淨很多。

可以再加強的地方

重複送出防護。使用者連點兩下送出按鈕,可能建立兩筆資料。可在 onSubmit 中立刻停用送出鈕,並在 success/error 中恢復:

var $btn = parent.$('#saveBtn');
$btn.prop('disabled', true);
// 於 success 與 error 的收尾處
$btn.prop('disabled', false);

error 回呼。目前只處理 success。網路中斷時表單會停在 loading 狀態,應補上:

error: function (xhr, status, err) {
  parent.$.messager.progress('close');
  parent.$.messager.alert('錯誤', '網路異常,請稍後再試');
}

把這些收尾細節補齊,表單提交才算真正可靠——多數「表單偶爾壞掉」的線上事故,都是卡在這幾個未處理的分支上。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved