DIV CSS 佈局教程網

jQuery + validationEngine:AJAX 驗證沒過卻照樣送出表單怎麼辦
編輯:JQuery特效代碼     

validationEngine 大幅減少了前端表單驗證的工作量,但搭配 AJAX 使用時有一個很典型的坑:欄位明明驗證失敗,表單卻還是送出去了。以下把常見的四種使用情境拆開來談,並給出不必改原始碼的解法。

情境一:純表單提交

最單純的用法。validationEngine 驗證不通過時會阻擋 submit,表單不會送出,沒有任何問題。

情境二:AJAX 提交,不做 AJAX 驗證

在發出請求之前先跑一次驗證,不通過就直接 return,這是成本最低也最穩定的做法。

代碼如下:

// 驗證不通過時 return
if (!$("form#ajaxForm").validationEngine("validate")) return;
$.ajax({
    type: "POST",
    url: $("#ajaxForm").attr("action"),
    data: $("#ajaxForm").serialize(),
    dataType: "html",
    success: function (data) { /* 處理回應 */ }
});

情境三:表單提交,但啟用了 AJAX 驗證

這是最常見的困擾點。網路上多數解法是直接改 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
    });
});

情境四:AJAX 驗證 + AJAX 提交

改原始碼的做法在這裡也派不上用場,需要換一個思路:把「需要走後端驗證的欄位」自己管起來。

通用解法:用自訂屬性登記欄位

第一步,在 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 的原始碼,升級外掛時也不會衝突。

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