validationEngine 大幅減少了前端表單驗證的工作量,但搭配 AJAX 使用時有一個很典型的坑:欄位明明驗證失敗,表單卻還是送出去了。以下把常見的四種使用情境拆開來談,並給出不必改原始碼的解法。
最單純的用法。validationEngine 驗證不通過時會阻擋 submit,表單不會送出,沒有任何問題。
在發出請求之前先跑一次驗證,不通過就直接 return,這是成本最低也最穩定的做法。
代碼如下:
// 驗證不通過時 return
if (!$("form#ajaxForm").validationEngine("validate")) return;
$.ajax({
type: "POST",
url: $("#ajaxForm").attr("action"),
data: $("#ajaxForm").serialize(),
dataType: "html",
success: function (data) { /* 處理回應 */ }
});
這是最常見的困擾點。網路上多數解法是直接改 validationEngine 原始碼,但改核心檔風險高,容易在別的地方衍生副作用。更麻的是,官方範例裡的 onBeforeAjaxFormValidation 回呼實際上並不會被觸發,因此也無法用來攔截。
代碼如下:
function beforeCall(form, options) {
console.log("表單驗證通過後、Ajax 送出前的回呼");
return true;
}
function ajaxValidationCallback(status, form, json, options) {
if (status === true) { alert("表單合法"); }
}
jQuery(document).ready(function () {
jQuery("#formID").validationEngine({
ajaxFormValidation: true,
ajaxFormValidationMethod: 'post',
onAjaxFormComplete: ajaxValidationCallback,
onBeforeAjaxFormValidation: beforeCall
});
});
改原始碼的做法在這裡也派不上用場,需要換一個思路:把「需要走後端驗證的欄位」自己管起來。
第一步,在 form 上自訂一個 control 屬性,值為需要 AJAX 驗證的欄位 id,多個以逗號分隔:
代碼如下:
<form method="post" id="ajaxForm2Controls" action="admin/user/savePro.htm" control="userName">
第二步,在每個欄位上標註驗證網址與失敗提示:
代碼如下:
<input class="textBox validate[required,minSize[6],maxSize[128],custom[onlyLetterNumber]]"
type="text" name="userName" id="userName" maxlength="128"
url="admin/user/uniqueName.htm" error="用戶已存在..."/>
第三步,宣告兩個全域陣列暫存錯誤欄位與訊息:
代碼如下:
var controlId = new Array(); // 驗證未通過的欄位 id
var errors = new Array(); // 對應的提示訊息
整體流程是:讀取 form 的 control 屬性並以逗號切分出欄位清單,為每個欄位掛上 blur 事件去呼叫後端檢查;一旦失敗就把 id 與訊息塞進陣列並即時提示。使用者按送出時,先檢查 controlId 是否為空——不為空就逐筆顯示錯誤並中止送出。
代碼如下:
$(function () {
var ajaxForm2Controls = $("form#ajaxForm2Controls");
$(ajaxForm2Controls).submit(function () {
ajaxForm2Control(ajaxForm2Controls);
return false;
});
valControls(ajaxForm2Controls);
});
function ajaxForm2Control(obj) {
if (controlId.length > 0) { alertinfo(); return false; }
// 先跑不需要後端的一般驗證
if (!$(obj).validationEngine("validate")) return false;
$.ajax({
type: "POST",
url: $(obj).attr("action"),
data: $(obj).serialize(),
dataType: "html",
success: function (data) { /* 處理回應 */ }
});
}
function valControls(ajaxForm2Controls) {
var controlsStr = ajaxForm2Controls.attr("control");
if (typeof (controlsStr) === "undefined" || controlsStr.length <= 0) return;
var controls = controlsStr.split(/,/g);
for (var i in controls) {
$("#" + controls[i]).blur(function () {
if ($(this).val().length <= 0) return false;
controlId.length = 0;
errors.length = 0;
var error = $(this).attr("error");
$.ajax({
type: "GET",
url: $(this).attr("url"),
dataType: "text",
success: function (data) {
if (data === "true") {
controlId.push($(this).attr("id"));
errors.push(error);
alertinfo();
}
}
});
});
}
}
function alertinfo() {
if (controlId.length > 0) {
for (var i in controlId) {
// 在指定元素上彈出提示,第三參數可取 pass / error / load
$("#" + controlId[i]).validationEngine("showPrompt", errors[i], "error");
}
}
}
不論走情境三還是情境四,送出前只要多檢查一次 controlId 有沒有值,就能把「驗證失敗卻仍送出」的問題擋下來,而且完全不必碰 validationEngine 的原始碼,升級外掛時也不會衝突。