DIV CSS 佈局教程網

JavaScript 客戶端快捷鍵管理器:完整實作與使用範例
編輯:關於JavaScript     

表單多的後台系統,若能一鍵把焦點跳到指定欄位,操作效率會差很多。以下實作一個陽春的快捷鍵管理器,支援「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 其實只是替換零件而已。

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