DIV CSS 佈局教程網

JavaScript 表單驗證封裝開發實踐
編輯:關於JavaScript     

本文分享一個把表單驗證邏輯集中管理的封裝思路,用「規則表 + 統一入口」的方式替代散落各處的 if-else。

在線 demo:https://www.hui12.com/nbin/csdn/jsInput/demo.html

效果預覽:

設計思路

核心只有兩個方法:

add:把「表單元素 + 校驗規則名」註冊進緩存,數組形式 [$("#name"), "testName"],支持一次傳多組。

get:觸發校驗並取回結果。傳單個元素返回 {result, txt};傳數組返回結果數組;不傳參數則校驗全部。

特殊規則需要額外參數,例如長度區間 get([$el, min, max])、兩次輸入一致性 get([$el1, $el2], "same")。

核心代碼

(function(window, $) {
    var proto = {
        /* ---------- 各項校驗規則 ---------- */
        testName: function($obj) {
            var str = $obj.val();
            if (!this.checkNormal(str)) return { result: false, txt: "需由字母與數字組成" };
            if (!this.checkLength(str, 6, 20)) return { result: false, txt: "長度需為 6-20 個字符" };
            if (!this.checkFirstA(str)) return { result: false, txt: "第一個字符不能為數字" };
            return { result: true, txt: "" };
        },

        testPassword: function($obj) { return this.testName($obj); },

        testPhone: function($obj) {
            return /^1\d{10}$/.test($obj.val())
                ? { result: true, txt: "" }
                : { result: false, txt: "手機號碼由 11 位數字組成" };
        },

        testQQ: function($obj) {
            return /^\d{5,10}$/.test($obj.val())
                ? { result: true, txt: "" }
                : { result: false, txt: "需為 5~10 位數字" };
        },

        // 特殊規則:字節長度區間
        testLength: function($obj, a, b) {
            return this.checkLength($obj.val(), a, b)
                ? { result: true } : { result: false };
        },

        testEmail: function($obj) {
            var re = /^(\w-*\.*)+@(\w-?)+\.(\w{2,})+$/;
            return re.test($obj.val())
                ? { result: true, txt: "" }
                : { result: false, txt: "郵箱格式不正確" };
        },

        // 特殊規則:兩項是否一致
        testSame: function($obj1, $obj2) {
            return $obj1.val() == $obj2.val()
                ? { result: true, txt: "" }
                : { result: false, txt: "兩次輸入不一致" };
        },

        testWX: function($obj) {
            return /^[a-z_\d]+$/i.test($obj.val())
                ? { result: true, txt: "" }
                : { result: false, txt: "微信號格式不正確" };
        },

        testPlane: function($obj) {
            return /^\d{3,4}-\d{5,8}$/.test($obj.val())
                ? { result: true, txt: "" }
                : { result: false, txt: "格式為:010-1234567" };
        },

        testManCard: function($obj) {
            var reg = /(^\d{15}$)|(^\d{18}$)|(^\d{17}(\d|X|x)$)/;
            return reg.test($obj.val())
                ? { result: true }
                : { result: false, txt: "請輸入正確的身份證號碼" };
        },

        /* ---------- 基礎工具方法 ---------- */
        checkEmpty: function(str) { return str.trim() != ''; },

        checkFirstA: function(str) { return !/\d/.test(str.charAt(0)); },

        checkNormal: function(str) {
            return /^(([a-z]+[0-9]+)|([0-9]+[a-z]+))[a-z0-9]*$/i.test(str);
        },

        checkLength: function(str, a, b) {
            return str.length >= a && str.length <= b;
        },

        /* ---------- 註冊規則 ---------- */
        add: function(arr) {
            !this.cache && (this.cache = []);
            var isTwo = $.isArray(arr[0]);   // 判斷是否一次傳多組
            isTwo ? this.cache = this.cache.concat(arr) : this.cache.push(arr);
            return this;                     // 支持鏈式調用
        },

        /* ---------- 執行校驗 ---------- */
        get: function() {
            var This = this;
            var args = arguments;

            // 不傳參數:校驗全部,返回數組
            if (args.length === 0) {
                var tmp = [];
                $.each(This.cache, function(i, val) {
                    var newArr = [].concat(val);
                    newArr.splice(1, 1);     // 去掉規則名,只留元素與參數
                    tmp.push(newArr);
                });
                return merges(tmp, 10);
            }

            if ($.isArray(args[0])) {
                var tmp = [];
                // 情況1:帶參數的單個檢測 [obj, 2, 3]
                if (!isNaN(args[0][1]) || !isNaN(args[0][2])) {
                    tmp.push(args[0]);
                    return merges(tmp, 1);
                }
                // 情況2:兩項一致性檢測 [obj, obj, 'same']
                if (args[0][2] == 'same') {
                    args[0].splice(2, 1);
                    tmp.push(args[0]);
                    return merges(tmp, 1);
                }
                // 情況3:多個檢測
                $.each(args[0], function(i, val) {
                    tmp.push($.isArray(val) ? val : [val]);
                });
                return merges(tmp);
            }

            // 常規單個檢測
            return merges([[args[0]]], 1);
        }
    };

    // 統一出口:根據註冊的規則名找到對應方法並執行
    function merges(arr, one) {
        // arr 結構:[ [obj, a, b], [obj] ]
        var result = [];

        $.each(arr, function(i, val) {
            var oldName = val[0][0];   // 原生 dom 對象
            var tName;                 // 規則方法名

            $.each(This.cache, function(i2, val2) {
                if (oldName == val2[0][0]) {
                    tName = val2[1];
                    return false;
                }
            });

            var r;
            if (one == 10) {
                // 全部校驗時,特殊規則單獨提示
                if (tName == "testLength" || tName == "testSame") {
                    r = { tName: "請單獨獲取" };
                } else {
                    r = This[tName].apply(This, val);
                }
            } else {
                r = This[tName].apply(This, val);
            }

            if (one == 1) {
                result.push(r);
                return false;
            }
            r.obj = val[0];            // 多元素校驗時掛上元素,便於定位
            result.push(r);
        });

        return one == 1 ? result[0] : result;
    }

    function Test() { return this; }
    Test.prototype = proto;
    Test.prototype.constructor = Test;
    window.Test = Test;
})(window, jQuery);

add 與 get 的實現要點

add 用 $.isArray(arr[0]) 判斷調用者是一次傳一組還是傳二維數組,前者 push、後者 concat,最後返回 this 支持鏈式寫法。

get 的分支判斷是整個封裝的關鍵:

// 不傳參 → 校驗全部
if (args.length === 0) { /* 遍歷 cache,剝掉規則名後交給 merges */ }

// 傳數組 → 三種情況
// 1. [obj, 2, 3]          帶參數的單項檢測
// 2. [obj, obj, 'same']   兩項一致性檢測
// 3. [obj, obj]           多項檢測,可能與上面兩種疊加

// 傳 dom 對象 → 常規單項,包成二維數組後調用 merges([[args[0]]], 1)

之所以內部統一用二維數組 [ [obj, a, b], [obj] ],是因為部分規則需要額外參數,只有統一結構才能讓 merges 用同一套邏輯遍歷。第二個參數 one 則是模式開關:1 表示只取單個結果並直接返回對象,10 表示全量校驗並對特殊規則做保護。

想更深入學習的話,可以參考 jQuery 表單驗證大全與 JavaScript 表單驗證大全兩個專題。

以上就是本文的全部內容,希望對大家的學習有所幫助。

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