入門
Kibo不依賴任何東西。你只要把它放到你的HTML代碼裡就行了:
複製代碼 代碼如下:<script type="text/javascript" src="kibo.js"></script>
下載 kibo.js
建立一個Kibo對象執行個體,事件監聽器就建立起來了: 複製代碼 代碼如下:var k = new Kibo();
Kibo對象的構造器有一個選擇性參數——你指定的接收事件的HTML元素。可以是input, textarea 或 select,預設情況下是window.document。
文法和用法
本工具庫提供了兩個簡單的方法——down and up, 它們都接收兩個參數:一個按鍵或多個按鍵的組合或萬用字元,以及一個當有匹配的按鍵事件發生時調用的函數。這兩個方法都可以鏈式調用。
按鍵組合是指修飾鍵和字元鍵的組合,或者簡單的是一個或多個修飾鍵。你可以向這兩個方法傳入單個或一個數組形式的多個按鍵組合。
當函數被調用時,事件將被傳入這個函數。如果你的事件沒有什麼操作,忽略就行了。如果函數返回了false,事件的預設操作將被阻止。
Kibo裡提供了一個lastKey方法,用來查詢最後一次鍵盤事件是由什麼鍵產生的。它會返回鍵的名稱,如果在最後的一次按鍵是不支援的鍵,方法將返回undefined。除此之外,你還可以用lastKey判斷是否是某個特定的功能鍵被按下,它會要麼返回true 要麼返回 false。
受支援的按鍵
Kibo 支援下面的這些按鍵,拼字這些按鍵名時不區分大小寫:
修飾鍵 shift, ctrl, alt
字母鍵 從a 到 z
數字鍵 從0 到 9
功能鍵 從f1 到 f12
方向鍵 left, up, right, down
enter, esc, space, backspace, delete, insert, tab, page_up, page_down, home, end, caps_lock, num_lock
萬用字元 any, any arrow, any number, any letter, any f
例子
var k = new Kibo();
單鍵或多鍵組合 複製代碼 代碼如下:k.down(['up', 'down'], function() {
console.log('up or down arrow key pressed');
}).up('tab', function() {
console.log('TAB key released');
});
含有修飾鍵的按鍵組合 複製代碼 代碼如下:function handler() {
console.log('last key: ' + k.lastKey());
}
k.down(['shift q', 'ctrl alt x'], handler);
萬用字元 複製代碼 代碼如下:k.down(['any letter', 'any number'], function() {
console.log('letter or number key pressed');
console.log('shift key was' + (k.lastKey('shift') ? '' : ' not') + ' pressed');
});
k.up('any', function() {
console.log('key released');
});
阻止預設事件 複製代碼 代碼如下:k.down('f5', function() { return false; });
License
Kibo is released under the MIT License.