表單多的後台系統,若能一鍵把焦點跳到指定欄位,操作效率會差很多。以下實作一個陽春的快捷鍵管理器,支援「Ctrl / Alt / Shift + 指定鍵」的組合,也能把快捷鍵綁到任意函數上,並 automatically 檢查重複註冊。
每個快捷鍵用一個物件描述:鍵值字串、要聚焦的元素 id、元素所在的 document、是「聚焦」還是「執行函數」、以及按下時觸發還是放開時觸發。管理器則持有一個陣列,註冊時先檢查是否與既有項目衝突,再把 document.onkeydown 與 document.onkeyup 各自接上分派邏輯。
鍵值字串的約定如下:"c,50" 代表 Ctrl 加鍵碼 50;"a,50" 代表 Alt 加鍵碼 50;"s,50" 代表 Shift 加鍵碼 50;單寫 "50" 則是鍵碼 50 的單鍵(實務上建議只用組合鍵,以免干擾正常輸入)。
// 單一快捷鍵物件
function KeyOne(id, keys, dom, isfun, fun, iskeydown) {
this.id = id;
this.keys = keys;
this.dom = dom;
this.isfun = isfun;
this.fun = fun;
this.isKeydown = iskeydown;
}
// 快捷鍵管理器
var KeyConlor = {};
KeyConlor.list = [];
// 註冊「聚焦型」快捷鍵:按下後焦點落在指定 id 的元素上
// key 範例:"c,50" = Ctrl + 鍵碼 50;"a,50" = Alt + 鍵碼 50;"s,50" = Shift + 鍵碼 50
// id : 快捷鍵對應的焦點元素
// dom : id 元素所在的 document 物件
KeyConlor.addkeyfouse = function (id, key, dom, iskyedown) {
var keyone = new KeyOne(id, key, dom, false, null, iskyedown);
if (KeyConlor.KeyIsOK(keyone)) {
KeyConlor.list.push(keyone);
} else {
alert("快捷鍵 " + keyone.keys + " 已被註冊,不能重複註冊");
return false;
}
};
// 註冊「函數型」快捷鍵:按下後執行自訂方法
KeyConlor.addkeyfun = function (key, fun, iskeydown) {
var keyone = new KeyOne("", key, "", true, fun, iskeydown);
if (KeyConlor.KeyIsOK(keyone)) {
KeyConlor.list.push(keyone);
} else {
alert("快捷鍵 " + keyone.keys + " 已被註冊,重複註冊無效");
return false;
}
};
// 判斷是否重複註冊
KeyConlor.KeyIsOK = function (keyone) {
for (var i = 0; i < KeyConlor.list.length; i++) {
if (KeyConlor.list[i].keys == keyone.keys) {
return false;
}
}
return true;
};
接著是按下與放開兩個分派器。兩者的結構幾乎相同,只有「哪些項目要被處理」的判斷相反:
document.onkeydown = function () {
for (var i = 0; i < KeyConlor.list.length; i++) {
var keyone = KeyConlor.list[i];
if (!keyone.isKeydown) continue; // 只處理「按下觸發」的項目
var control = keyone.keys.split(",")[0];
var code = keyone.keys.split(",").length > 1
? keyone.keys.split(",")[1]
: keyone.keys.split(",")[0];
switch (control) {
case 's':
if (event.shiftKey == true && event.keyCode == code) { KeyConlor.fire(keyone); return false; }
break;
case 'c':
if (event.ctrlKey == true && event.keyCode == code) { KeyConlor.fire(keyone); return false; }
break;
case 'a':
if (event.altKey == true && event.keyCode == code) { KeyConlor.fire(keyone); return false; }
break;
default:
if (event.keyCode == code && !event.altKey && !event.ctrlKey && !event.shiftKey) {
KeyConlor.fire(keyone);
return false;
}
break;
}
}
};
// 抽出共同的觸發邏輯,避免在每個 case 重複張貼
KeyConlor.fire = function (keyone) {
if (!keyone.isfun) {
keyone.dom.getElementById(keyone.id).focus();
} else {
keyone.fun();
}
event.keyCode = 0;
};
// onkeyup 的寫法與 onkeydown 相同,只需把
// if (!keyone.isKeydown) continue; 改成
// if (keyone.isKeydown) continue;
var keyCodeStr = {
Alt: "a", Shift: "s", Ctrl: "c",
Up: "38", Down: "40", Left: "37", Right: "39",
Esc: "27", Enter: "13", Backspace: "8", Delete: "46",
Tab: "9", CapsLK: "20", Space: "32"
};
<script src="KyeControl.js" type="text/javascript"></script>
<script type="text/javascript">
// Ctrl + F1(鍵碼 70)彈出提示
KeyConlor.addkeyfun(keyCodeStr.Ctrl + "," + "70", function () {
alert("哈哈");
}, true);
// 按下 Alt + A(鍵碼 65)時,焦點跳到 id 為 "2" 的欄位
KeyConlor.addkeyfouse("2", "65", document, true);
</script>
<input type="text" id="2" />
<input type="text" id="3" />
<input type="text" id="4" />
<input type="text" id="5" />
必須誠實說明,這段程式是舊世代的寫法,有幾個明顯限制。它直接依賴全域 event,在 Firefox 等瀏覽器中需改成從參數取 e = e || window.event;它用 event.keyCode = 0 試圖吃掉事件,但真正阻止預設行為應該呼叫 preventDefault();鍵值以「逗號分隔字串」表達,每次比對都要 split,改成陣列會更直觀;重複註冊時用 alert 提示,在正式環境中應改成例外或回傳錯誤碼。
若今天要重寫,比較合適的做法是:以 event.code(如 KeyA、F1)取代 keyCode 以擺脫鍵盤配置的影響,用 addEventListener 取代直接指派 onkeydown,並在處理器裡檢查 ctrlKey / altKey / shiftKey / metaKey 的組合是否與註冊時完全一致,避免與瀏覽器或系統快捷鍵衝突。理解這份舊實作的註冊、分派、衝突偵測三層結構之後,要遷移到新 API 其實只是替換零件而已。