DIV CSS 佈局教程網

自製 jQuery 外掛:限制輸入框只能填數字
編輯:JQuery特效代碼     

手機號碼、身分證、金額欄位,往往只該接受數字。與其等送出後才驗證,不如在輸入階段就攔下來。本文示範如何把它包成一個可重複呼叫的 jQuery 外掛,並額外處理貼上與中文輸入法的情境。

外掛原始碼

(function ($) {
    var keyCode = {
        BACKSPACE: 8, CAPS_LOCK: 20, COMMA: 188, CONTROL: 17, DELETE: 46,
        DOWN: 40, END: 35, ENTER: 13, ESCAPE: 27, HOME: 36, INSERT: 45,
        LEFT: 37, PAGE_DOWN: 34, PAGE_UP: 33, PERIOD: 190, RIGHT: 39,
        SHIFT: 16, SPACE: 32, TAB: 9, UP: 38
    };

    // 這些是功能鍵,必須放行
    var isControlCode = function (key) {
        for (var name in keyCode) {
            if (keyCode[name] === key) return true;
        }
        return false;
    };

    // 只允許數字鍵
    var number = function (event) {
        if (event.shiftKey) return false;
        var key = event.keyCode;
        if (isControlCode(key)) return;
        if (key < 48 || key > 105) return false;      // 不在數字區
        if (key > 57 && key < 96) return false;    // 介於主鍵盤與小鍵盤之間
    };

    var ControlList = {};

    var control = Class.extend({
        init: function (obj) {
            this.Event = [];
            this.target = $(obj);
        },
        Add: function (settings) {
            this.Event.push(settings);
            return this;
        },
        Bind: function () {
            var t = this;
            if (!t.target) return;
            t.target.each(function () {
                var b = $(this);
                b.bind("keydown", t.event.bind(t)).bind("keyup", t.event.bind(t));
                // 貼上也必須攔,IE 用 paste,其餘用 input
                if (jQuery.browser.msie) {
                    b.bind("paste", t.event.bind(t));
                } else {
                    b.bind("input", t.event.bind(t));
                }
            });
        },
        getmethods: function (type) {
            var list = [];
            $(this.Event).each(function (i, item) {
                if (!item.type || !item.method) return;
                if (item.type === "all" || item.type === type) {
                    list.push(item.method);
                }
            });
            return list;
        },
        IsSuccess: function (list, event, obj) {
            for (var i = 0; i < list.length; i++) {
                if (list[i].call(obj, event) === false) return false;
            }
            return true;
        },
        event: function (ev) {
            var t = this;
            return t.IsSuccess(t.getmethods(ev.type), ev.originalEvent, ev.target);
        }
    });

    control.Add = function (obj, settings) {
        var con = ControlList[this.selector];
        if (!con) {
            con = new control(obj);
            ControlList[this.selector] = con;
            con.Bind();
        }
        con.Add(settings);
        return control;
    };

    $.fn.numberable = function () {
        $(this).css("imeMode", "disabled");   // 關閉中文輸入法
        control.Add(this, { type: "keydown", method: number })
              .Add(this, { type: "keyup",   method: number });

        // 貼上後清掉非數字字元
        function repnumber(event) {
            var o = $(this);
            if (o.val()) o.val(o.val().replace(/[^\d]/g, ""));
        }

        if (jQuery.browser.msie) {
            control.Add(this, { type: "paste", method: function (event) {
                setTimeout(repnumber.bind(this, event), 0);
            }});
        } else {
            control.Add(this, { type: "input", method: repnumber });
        }
        return this;
    };
})(jQuery);

使用方式

$(".class").numberable();

設計思路與現代寫法

這支外掛的架構相當值得參考:它把「事件型別 → 處理函式」的對應抽成一份清單(this.Event),再由 getmethods() 依事件名稱取出要跑的函式,形成一個小型的事件管線。這樣的設計讓它很容易擴充——想加上「只能輸入大寫」或「限制長度」,只要多 Add 一筆設定即可。

攔截策略分兩層:keydown 階段擋掉非數字的按鍵,input/paste 階段再用正則 replace(/[^\d]/g, "") 清一遍。之所以需要第二層,是因為使用者可以透過貼上、拖曳、瀏覽器自動填入等方式繞過按鍵攔截。

不過這份程式碼有兩個明顯的時代痕跡。Class.extend() 出自 Prototype 一类的 class 模擬庫,而 jQuery.browser 已在 jQuery 1.9 中移除。若要在現代專案中使用,建議改寫如下:

$.fn.numberable = function () {
    return this.each(function () {
        var $el = $(this);
        $el.attr("inputmode", "numeric");     // 手機鍵盤直接開數字
        $el.on("input blur", function () {
            this.value = this.value.replace(/\D/g, "");
        });
        $el.on("keypress", function (e) {
            if ((e.which < 48 || e.which > 57) && e.which !== 0) {
                e.preventDefault();
            }
        });
    });
};

關鍵差異有三點:用 on() 取代已弃用的 bind(),用 inputmode 屬性取代 imeMode 的 CSS hack,並以單一 input 事件取代跨瀏覽器的 paste/input 判斷。程式碼短了一半以上,行為反而更一致。

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