前幾天做表單驗證,需要用 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 也不是可有可無的裝飾——它會自動在網址後附加時間戳,避免同名稱的兩次檢查命中瀏覽器快取而拿到舊結果。
這個寫法能解決問題,卻不該是最終答案。同步請求會凍結整個瀏覽器 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 狀態;網路失敗有明確處理,不會讓使用者搞不清楚為什麼沒反應;而且成功送出前把按鈕停用,順便防住了重複點擊。整體來說,代碼多幾行,但換來的是真正可用的使用者體驗。