DIV CSS 佈局教程網

限制輸入框只能填數字:從舊有做法到自製驗證的比較
編輯:關於JavaScript     

表單裡常有「只能填數字」的需求,例如金額、數量、比例。這個看似簡單的需求,實際做過就會發現坑不少。以下整理幾種曾經用過的方案,以及最後自己實作出來的做法。

曾經嘗試過的方法

以 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)。這兩個外掛彈性不錯,常見需求都能應付,但對於「輸入長度」的控制相對死板,很難針對整數位數與小數位數分別限制。

自製的實作思路

既然現成套件不夠合用,就自己拼一個。做法結合了幾個來源:

  • 借用 maskedInput 中的部分方法來取得游標位置。
  • 採用 Stack Overflow 上廣為流傳的通用鍵盤處理方式(html-text-input-allow-only-numeric-input)。
  • 參考 cambiaresearch.com 整理的 keycode 對照表補齊按鍵判斷。

接著自訂兩個 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 上切換到微軟拼音輸入法時可能無法輸入,其他系統或輸入法是否也有類似問題,值得再測試。

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