傳統表單提交會導致整頁刷新,體驗割裂。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>
$(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 才會真正提交
}
var options = {
target: '#output1',
data: { param1: "額外參數" }, // 附加到請求中的自定義參數
dataType: 'json', // 服務端返回 'json' 時會自動解析
type: 'POST', // 默認取 form 的 method
url: '', // 可在這裡覆寫提交地址
beforeSubmit: showRequest,
success: successRes
};
後台可用 request.getParameter("param1") 拿到那個額外參數。
只要把 dataType 設為 'json',成功回調的第一個參數就是已解析好的對象,可以直接取屬性:
var options = {
target: '#output1',
dataType: 'json',
beforeSubmit: showRequest,
success: successRes
};
function successRes(jsonData) {
alert(jsonData.param1);
}
驗證邏輯寫在 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,標準且無需額外依賴。