手機號碼、身分證、金額欄位,往往只該接受數字。與其等送出後才驗證,不如在輸入階段就攔下來。本文示範如何把它包成一個可重複呼叫的 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 判斷。程式碼短了一半以上,行為反而更一致。