DIV CSS 佈局教程網

表單 onsubmit 中用 Ajax 驗證時 return false 為何失效
編輯:關於JavaScript     

前幾天做表單驗證,需要用 Ajax 到後端檢查名稱是否重複,卻發現 return false 完全攔不住表單提交。以下記錄問題成因與解法。

出問題的程式碼

/**
 * 表單提交校驗
 **/
function onSubmit() {
    if ($('#name').val().length < 2) {
        alert("名稱請不少於兩個漢字");
        return false;
    }
    var t = new Date().getTime();
    $.ajax({
        type: "POST",
        url: "/users/checkrepeat/",
        data: "name=" + $('#name').val() + "&time=" + t,
        success: function (res) {
            if (res == 'exists') {
                alert("名稱已存在,請修改.");
                return false;
            }
        }
    });
}

為什麼沒用

兩個原因疊加在一起:

一、return false 的歸屬錯了。 success 回呼是另一個函式,它 return false 只是結束自己,跟外層的 onSubmit() 沒有任何關係。要攔住表單,必須由 onSubmit 本身回傳 false。

二、Ajax 預設是同步的。 更正確地說,是預設 async: true(非同步)。這代表請求發出後,瀏覽器不會停下來等回應,而是繼續往下執行後面的程式。等到伺服器回應、success 被觸發時,表單早就已經送出去了。整個過程其實是兩個獨立的執行緒在跑。

解法:改為同步請求

把 async 設為 false,讓程式停下來等回應,再用一個旗標變數記錄驗證結果:

/**
 * 表單提交校驗
 **/
function onSubmit() {
    if ($('#name').val().length < 2) {
        alert("名稱請不少於兩個漢字");
        return false;
    }

    var flag = true;
    var t = new Date().getTime();
    $.ajax({
        type: "POST",
        async: false,   // 設置同步方式
        cache: false,
        url: "/users/checkrepeat/",
        data: "name=" + $('#name').val() + "&time=" + t,
        success: function (res) {
            if (res == 'exists') {
                alert("名稱已存在,請修改.");
                flag = false;
            }
        }
    });
    if (!flag)
        return false;
}

這裡的 cache: false 也不是可有可無的裝飾——它會自動在網址後附加時間戳,避免同名稱的兩次檢查命中瀏覽器快取而拿到舊結果。

但同步 Ajax 是個壞主意

這個寫法能解決問題,卻不該是最終答案。同步請求會凍結整個瀏覽器 UI 執行緒:請求送出後,頁面完全無法捲動、無法點擊、連 loading 動畫都不會動,直到回應回來。網路稍慢,使用者就會以為網頁當機了。事實上主流瀏覽器已在主執行緒上標記同步 XHR 為不建議用法,並在控制台輸出警告。

更好的做法

正確的架構是:攔住表單提交 → 發非同步請求 → 在回呼中決定要送出還是提示錯誤。

$("#myForm").submit(function (e) {
    e.preventDefault();          // 先擋下來
    var $btn = $(this).find(":submit").prop("disabled", true);
    $.ajax({
        type: "POST",
        url: "/users/checkrepeat/",
        data: { name: $("#name").val() },
        dataType: "json"
    }).done(function (res) {
        if (res.exists) {
            alert("名稱已存在,請修改.");
            $btn.prop("disabled", false);
        } else {
            e.currentTarget.submit();   // 驗證通過,真的送出
        }
    }).fail(function () {
        alert("驗證失敗,請稍後再試");
        $btn.prop("disabled", false);
    });
});

這個版本的好處是:UI 全程可操作,可以顯示 loading 狀態;網路失敗有明確處理,不會讓使用者搞不清楚為什麼沒反應;而且成功送出前把按鈕停用,順便防住了重複點擊。整體來說,代碼多幾行,但換來的是真正可用的使用者體驗。

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