DIV CSS 佈局教程網

用 jquery.form.js 把表單提交改造為 Ajax
編輯:JavaScript綜合知識     

傳統表單提交會導致整頁刷新,體驗割裂。jquery.form.js 提供了一層封裝,讓你幾乎不改 HTML 結構的情況下,把提交行為切換成 Ajax,同時還能拿到提交前的鉤子做驗證。

需要注意的是,這個插件要求配合 jQuery 完整版使用,壓縮版可能出現方法缺失。

原理

插件用 JS 把表單各字段組裝成 Ajax 的 URL 參數與 data 對象,本質上仍然是發起 Ajax 請求。這件事完全可以自己實現,但有了插件會省事很多,尤其是文件上傳場景。

第一步:引入依賴

<script type="text/javascript" src="js/jquery-1.7.min.js"></script>
<script type="text/javascript" src="js/jquery.form.js"></script>

第二步:編寫表單

<form id="showDataForm" action="/024pm/f_shopUser.do?method=login" method="post">
  <input type="text" value="" name="name" maxlength="2" />
  <input type="password" value="" name="password" maxlength="2" />
  <input type="submit" value="提交" />
</form>

<div id="output1" style="width:1000px;height:200px;background-color:#eee;"></div>

第三步:綁定 Ajax 提交

$(document).ready(function () {
  var options = {
    target: '#output1',        // 服務端返回的內容渲染到這個容器
    beforeSubmit: showRequest, // 提交前回調,用於驗證
    success: showResponse      // 提交成功回調
  };

  $('#showDataForm').submit(function () {
    $(this).ajaxSubmit(options);
    return false;   // 至關重要:false 阻止默認跳轉,走 Ajax
  });
});

function showResponse(responseText, statusText, xhr, $form) {
  alert(xhr.responseText + "==" + $form.attr("method")
        + ' status: ' + statusText + '\n responseText: \n' + responseText);
  // statusText 成功時為 success
  // responseText 是服務端返回的字符串(含 HTML,不含 JSON 對象)
}

function showRequest(formData, jqForm, options) {
  // formData 是各 input 的鍵值數組
  var queryString = $.param(formData);
  alert(queryString + "======" + formData.length);

  for (var i = 0; i < formData.length; i++) {
    alert(formData[i].value + "====" + formData[i].name);
  }

  // jqForm 是 jQuery 表單對象
  var formElement = jqForm[0];
  alert($(formElement).attr("method"));

  return true;   // 返回 true 才會真正提交
}

options 常用配置項

var options = {
  target: '#output1',
  data: { param1: "額外參數" },   // 附加到請求中的自定義參數
  dataType: 'json',               // 服務端返回 'json' 時會自動解析
  type: 'POST',                   // 默認取 form 的 method
  url: '',                        // 可在這裡覆寫提交地址
  beforeSubmit: showRequest,
  success: successRes
};

後台可用 request.getParameter("param1") 拿到那個額外參數。

解析服務端返回的 JSON

只要把 dataType 設為 'json',成功回調的第一個參數就是已解析好的對象,可以直接取屬性:

var options = {
  target: '#output1',
  dataType: 'json',
  beforeSubmit: showRequest,
  success: successRes
};

function successRes(jsonData) {
  alert(jsonData.param1);
}

在 beforeSubmit 中做驗證

驗證邏輯寫在 beforeSubmit 裡最合適,因為它能拿到 formData 和 jqForm 兩個對象:

function showRequest(formData, jqForm, options) {
  for (var i = 0; i < formData.length; i++) {
    if (!formData[i].value) {
      alert('存在未填寫的表單項');
      return false;     // 返回 false 阻止提交
    }
  }
  return true;
}

總體來講,這個插件把「序列化表單 + 發請求 + 局部渲染 + 提交前鉤子」四件事打包好了。若是新項目,更推薦直接用 fetch 配合 FormData,標準且無需額外依賴。

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