表單裡常有「只能填數字」的需求,例如金額、數量、比例。這個看似簡單的需求,實際做過就會發現坑不少。以下整理幾種曾經用過的方案,以及最後自己實作出來的做法。
以 onkeydown 攔下按鍵碼
<input onkeydown="return event.keyCode>=48&&event.keyCode<=57||event.keyCode>=96&&event.keyCode<=105" />
寫法確實短,但問題是鍵盤上的按鍵遠比數字多:退格、Tab、Enter、方向鍵、Home、End、Ctrl+A 全都會被擋掉,使用者體驗很差,實測下幾乎不能用。
使用 jQuery 外掛
例如 Masked Input(digitalbush.com/projects/masked-input-plugin)與 MeioMask(github.com/fabiomcosta/jquery-meiomask)。這兩個外掛彈性不錯,常見需求都能應付,但對於「輸入長度」的控制相對死板,很難針對整數位數與小數位數分別限制。
既然現成套件不夠合用,就自己拼一個。做法結合了幾個來源:
接著自訂兩個 data 屬性,讓長度限制可以針對每個欄位個別設定:
data-numbers:整數部分的最大位數。data-decimals:小數部分的最大位數。function validateDigitsOnly(evt) {
var e = evt || window.event,
key = e.keyCode || e.which;
if (
// Backspace, Tab, Enter, Esc, Delete
key == 8 || key == 9 || key == 13 || key == 27 || key == 46 ||
// Ctrl + A
(key == 65 && event.ctrlKey === true) ||
// Home, End, 四個方向鍵
key >= 35 && key <= 40) {
return;
}
if (e.shiftKey || e.altKey || e.ctrlKey) {
return false;
}
var el = e.target || e.srcElement,
// 最大數字長度
nl = el.getAttribute("data-numbers") || 15,
// 最大小數長度
dl = el.getAttribute("data-decimals") || 2,
val = el.value,
// "." 位置
dotIndex = val.indexOf("."),
rng = caret.call(el),
// 游標在"."左邊
rLeft = rng.end <= dotIndex,
// 游標在"."右邊
rRight = rng.begin > dotIndex;
if (
// 數字
key >= 48 && key <= 57 ||
// 數字鍵盤輸入的數字
key >= 96 && key <= 105) {
if (validateValue(dotIndex, val, rLeft, rRight, nl, dl))
return;
// 選中部分文本再做一次處理
val = val.substring(0, rng.begin) + val.substring(rng.end);
dotIndex = val.indexOf(".");
if (validateValue(dotIndex, val, rLeft, rRight, nl, dl))
return;
}
else if (
// ".", ","
(key == 190 /*|| key == 188*/ ||
// 數字鍵盤上的 ".", ","
key == 110/*|| key == 109*/) &&
// 允許輸入小數
dl > 0) {
if (
// 未輸入".",且輸入位置後面的小數位數未達到上限
dotIndex == -1 && (rng.end == val.length || val.substring(rng.end).length <= dl) ||
// 輸過".",且選中部分文本包含"."
dotIndex > -1 && rng.begin <= dotIndex && dotIndex < rng.end)
return;
}
return false;
}
// 驗證輸入的值
function validateValue(dotIndex, val, rLeft, rRight, nl, dl) {
if (
// 未輸入過"."
dotIndex == -1 && val.length < nl ||
// 游標位置在"."之前
rLeft && val.substring(0, dotIndex).length < nl ||
// 游標在"."之後且未達到小數上限
rRight && val.substring(dotIndex + 1).length < dl)
return true;
return false;
}
// 獲取游標位置
function caret() {
var begin, end;
if (this.setSelectionRange) {
begin = this.selectionStart;
end = this.selectionEnd;
} else if (document.selection && document.selection.createRange) {
var range = document.selection.createRange();
begin = 0 - range.duplicate().moveStart('character', -100000);
end = begin + range.text.length;
}
return { begin: begin, end: end };
}
直接綁定 onkeydown 即可,不設 data 屬性時會使用預設值(整數 15 位、小數 2 位):
<input type="text" id="t1" />
<input type="text" id="t2" data-numbers="5" data-decimals="4" />
<script>
document.getElementById("t1").onkeydown = validateDigitsOnly;
document.getElementById("t2").onkeydown = validateDigitsOnly;
</script>
也可以直接寫在標籤上:
<input type="text" id="lwme_text_3" onkeydown="return validateDigitsOnly(event)" />
如果頁面已經引入 jQuery,寫法會更簡潔:
<input type="text" class="digitsOnly" />
$(".digitsOnly").keydown(validateDigitsOnly);
這個方法在少數情境下效率還不算理想,部分按鍵也尚未完全涵蓋,某些特殊操作仍可能繞過。但就一般表單而言已經足夠。
要特別留意兩類「非鍵盤輸入」的漏洞:一是用滑鼠右鍵選單或選單列貼上內容;二是把網頁中的文字拖曳進輸入框,或在輸入框內拖動選取的文字。這兩種情況都不會觸發 keydown。
比較省事的做法是再疊一層表單驗證,例如 jQuery.validate,在送出前統一檢查格式,比逐一補齊各種鍵盤與貼廣事件來得實際。
另外一個實測到的狀況:在 Windows 8 上切換到微軟拼音輸入法時可能無法輸入,其他系統或輸入法是否也有類似問題,值得再測試。