入門
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.