DIV CSS 佈局教程網

用 jQuery Validate 的 remote 規則非同步檢查帳號是否可用
編輯:JQuery入門技巧     

註冊表單的帳號可用性檢查必須問後端,這正是 jQuery Validate 的 remote 規則的用途:把欄位值送到伺服器,由回應決定通過與否。

一、引入

<script type="text/javascript" src="../js/jquery-1.3.2.min.js"></script>
<script type="text/javascript" src="../js/jquery.validate.min.js"></script>
<script type="text/javascript" src="../js/messages_cn.js"></script>

二、表單

<form name="form1" id="form1" method="post" action="">
  <dl>
    <dt>用戶名:</dt>
    <dd><input name="txtUserName" id="txtUserName" type="text" class="input1" /></dd>
  </dl>
</form>

三、驗證設定

$(function () {
    $("#form1").validate({
        errorElement: "span",     // 錯誤訊息使用的標籤
        rules: {
            txtUserName: {
                required: true,
                minlength: 3,
                maxlength: 16,
                remote: {
                    type: "post",
                    url: "/tools/ValidateUserName.ashx",
                    data: {
                        username: function () {
                            return $("#txtUserName").val();
                        }
                    },
                    dataType: "html",
                    dataFilter: function (data, type) {
                        return data == "true";
                    }
                }
            }
        },
        success: function (label) {
            label.text(" ").addClass("success");
        },
        messages: {
            txtUserName: {
                required: "請輸入用戶名,3-16 個字符(字母、數字、下劃線),註冊後不能更改",
                minlength: "用戶名長度不能小於 3 個字符",
                maxlength: "用戶名長度不能大於 16 個字符",
                remote: "用戶名不可用"
            }
        }
    });
});

關鍵細節:data 必須用函式回傳

data: { username: function () { return $("#txtUserName").val(); } }

若寫成 data: { username: $("#txtUserName").val() },該值會在頁面初始化時就被求值並固定下來,之後每次驗證送出的都是同一個舊值,永遠拿不到使用者當下輸入的內容。這是最常踩的坑。

其他實務提醒

dataType 建議改為 json。範例用 dataType: "html" 再把 "true" / "false" 字串轉布林,顯得多餘。後端直接回傳 {"valid": true} 並搭配:

remote: {
    url: "/tools/ValidateUserName.ashx",
    data: { username: function () { return $("#txtUserName").val(); } },
    dataType: "json",
    dataFilter: function (data) {
        return data.valid;
    }
}

後端回應只能是布林。jQuery Validate 的 remote 規則只認 true / false(經 dataFilter 轉換後),無法直接回傳自訂訊息。若需要「此帳號已被 john 使用」這類動態文字,得自行發請求並用 showErrors 或手動插入提示節點。

加上 debounce。remote 規則在 onkeyup 時每按一次鍵就發一次請求。註冊頁尤其要避免,否則後端會收到一串「j」、「jo」、「joh」、「john」的查詢。實務上常見做法是移除 onkeyup,只在 onfocusout 時檢查。

後端務必再驗一次。前端檢查只是引導使用者,註冊送出時(action 的處理端)必須重新確認帳號未被占用並加上唯一索引,否則兩人同時註冊同一帳號的競態情況仍會發生。

版本:範例使用 jQuery 1.3.2 與舊版 validate,屬相當早期的組合。新專案建議採用 3.x 搭配 jquery-validation 1.19+,並以 on() 取代已廢棄的 bind() / live()。

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