DIV CSS 佈局教程網

jQuery 表單驗證擴展(三):把提示文字與樣式抽成參數
編輯:JQuery特效代碼     

本文是在前兩篇的基礎上改寫的。這次的主要目標是把提示文字與樣式從驗證邏輯裡徹底剝離出來,全部改成可傳參數,同時補上 radio、checkbox、select 的驗證。

一、沿用與待解的問題

第二篇提到的問題在舊版驗證中同樣存在,這次改寫順手解決了幾個。radio/checkbox/select 的驗證也補上了,但日期型別的驗證仍未完成,後續再補。

二、參數設計

onEmptyText     輸入為空時顯示的文字
onEmptyClass    輸入為空時套用的樣式
onSuccessText   驗證通過顯示的文字
onSuccessClass  驗證通過套用的樣式
onErrorText     驗證失敗顯示的文字
onErrorClass    驗證失敗套用的樣式
onFocusText     取得焦點時顯示的文字
onFocusClass    取得焦點時套用的樣式
dataType        資料型別:text / number / date
min             允許的最小值(或最小長度)
max             允許的最大值(不含)
targetId        顯示提示訊息的目標元素 id

目前支援 text、number、date 三種型別,其中 date 尚未實作。radio、checkbox、select 只驗證是否選中/選中數量,不做文字或日期判斷。另外 select 對 blur 事件的反應不夠即時,所以改用 change 事件來驗證。

三、核心程式碼

$.fn.extend({
    checkRange: function (inputArg) {
        // 取得焦點
        $(this).bind("focus", function () {
            var flag = true;
            if ($(this).is("input") || $(this).is("textarea")) {
                if ($(this).attr("type") == "radio" || $(this).attr("type") == "checkbox") {
                    var name = $(this).attr("name");
                    if ($('input[@name="' + name + '"][checked]').length > 0) { flag = false; }
                } else {
                    if ($(this).val() != undefined && $(this).val() != "") { flag = false; }
                }
            }
            // select 沒有 focus 事件,改由 change 處理
            if (flag) {
                addText(inputArg.targetId, inputArg.onFocusText);
                addClass(inputArg.targetId, inputArg.onFocusClass);
            }
        });

        // 失去焦點
        $(this).bind("blur", function () {
            var flag = false;
            if ($(this).is("input") || $(this).is("textarea")) {
                if ($(this).attr("type") == "radio" || $(this).attr("type") == "checkbox") {
                    var name = $(this).attr("name");
                    var items = $('input[@name="' + name + '"][checked]');
                    if (items != undefined && items.length >= inputArg.min
                        && items.length < inputArg.max) { flag = true; }
                } else {
                    var value = $(this).val();
                    if (value == undefined || value == "") {
                        addText(inputArg.targetId, inputArg.onEmptyText);
                        addClass(inputArg.targetId, inputArg.onEmptyClass);
                    } else {
                        switch (inputArg.dataType) {
                            case "text":
                                flag = !(value.length < inputArg.min || value.length >= inputArg.max);
                                break;
                            case "number":
                                if (isNaN(value)) { flag = false; }
                                else { flag = !(value < inputArg.min || value >= inputArg.max); }
                                break;
                            case "date":
                                break;   // 待實作
                        }
                    }
                }
            }
            addMessage(flag, inputArg);
        });

        // select 用 change 事件驗證,支援多選數量檢查
        if ($(this).is("select")) {
            $(this).bind("change", function () {
                var items = $(this).find("option:selected");
                addMessage(
                    items != undefined && items.length >= inputArg.min
                    && items.length < inputArg.max,
                    inputArg);
            });
        }
    }
});

四、抽出來的公用方法

// 依驗證結果統一輸出提示與樣式
function addMessage(flag, inputArg) {
    if (flag) {
        addText(inputArg.targetId, inputArg.onSuccessText);
        addClass(inputArg.targetId, inputArg.onSuccessClass);
    } else {
        addText(inputArg.targetId, inputArg.onErrorText);
        addClass(inputArg.targetId, inputArg.onErrorClass);
    }
}

function addText(targetId, text) {
    if (text == undefined) { text = ""; }
    $("#" + targetId).html(" " + text);
}

function addClass(targetId, className) {
    if (className != undefined && className != "") {
        $("#" + targetId).removeClass();
        $("#" + targetId).addClass(className);
    }
}

這次重構把重複出現的「顯示文字+切換樣式」抽成 addMessage,程式碼量少了幾乎一半,可讀性也上來了。

五、效果與測試

文字框長度不符:

數字驗證——取得焦點、超出範圍、通過:

checkbox 群組驗證:

select 多選數量驗證:

六、呼叫範例

$(document).ready(function () {
    $("#txtName").checkRange({
        onFocusText: "必填項", onFocusClass: "notice", targetId: "txtNameTip",
        onSuccessText: "驗證成功", onSuccessClass: "correct",
        onErrorText: "請認真填寫", onErrorClass: "error",
        min: 6, max: 12, dataType: "text"
    });

    $("#txtAge").checkRange({
        onFocusText: "必填項", onFocusClass: "notice", targetId: "txtAgeTip",
        onSuccessText: "驗證成功", onSuccessClass: "correct",
        onErrorText: "輸入的範圍為 10-60", onErrorClass: "error",
        min: 10, max: 60, dataType: "number"
    });

    // checkbox 群組:至少選 1 個、最多 3 個
    $("#rdbMan1,#rdbWoman2,#rdbMan3,#rdbWoman4").checkRange({
        onFocusText: "必填項", onFocusClass: "notice", targetId: "txthobbyTip",
        onSuccessText: "驗證成功", onSuccessClass: "correct",
        onErrorText: "請認真填寫", onErrorClass: "error",
        min: 1, max: 3, dataType: "text"
    });

    // 多選 select:選 1 項
    $("#ddlOption").checkRange({
        onFocusText: "必填項", onFocusClass: "notice", targetId: "ddlOptionTip",
        onSuccessText: "驗證成功", onSuccessClass: "correct",
        onErrorText: "請認真填寫", onErrorClass: "error",
        min: 1, max: 2, dataType: "number"
    });
});

一個必須修正的寫法:範例中用的 $('input[@name="xxx"][checked]') 是 jQuery 1.2 的老語法,1.3 之後 @ 前綴已移除,必須改寫成 $('input[name="xxx"]:checked'),否則在現代版本上會直接拋出語法錯誤。

後續會持續更新,特別是日期驗證的部分。

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