Kibo 用于處理鍵盤(pán)事件的Javascript工具庫(kù)

更新時(shí)間：2011年10月28日 14:53:25 作者：

Kibo是一個(gè)簡(jiǎn)單的用于處理鍵盤(pán)事件的Javascript工具庫(kù)。

入門(mén)
Kibo不依賴(lài)任何東西。你只要把它放到你的HTML代碼里就行了：

復(fù)制代碼代碼如下:

下載 kibo.js
創(chuàng)建一個(gè)Kibo對(duì)象實(shí)例，事件監(jiān)聽(tīng)器就建立起來(lái)了：

復(fù)制代碼代碼如下:

var k = new Kibo();

Kibo對(duì)象的構(gòu)造器有一個(gè)可選參數(shù)——你指定的接收事件的HTML元素。可以是input, textarea 或 select，缺省情況下是window.document。

語(yǔ)法和用法
本工具庫(kù)提供了兩個(gè)簡(jiǎn)單的方法——down and up，它們都接收兩個(gè)參數(shù)：一個(gè)按鍵或多個(gè)按鍵的組合或通配符，以及一個(gè)當(dāng)有匹配的按鍵事件發(fā)生時(shí)調(diào)用的函數(shù)。這兩個(gè)方法都可以鏈?zhǔn)秸{(diào)用。

按鍵組合是指控制鍵和字符鍵的組合，或者簡(jiǎn)單的是一個(gè)或多個(gè)控制鍵。你可以向這兩個(gè)方法傳入單個(gè)或一個(gè)數(shù)組形式的多個(gè)組合鍵。

當(dāng)函數(shù)被調(diào)用時(shí)，事件將被傳入這個(gè)函數(shù)。如果你的事件沒(méi)有什么操作，忽略就行了。如果函數(shù)返回了false，事件的缺省操作將被阻止。

Kibo里提供了一個(gè)lastKey方法，用來(lái)查詢(xún)最后一次鍵盤(pán)事件是由什么鍵產(chǎn)生的。它會(huì)返回鍵的名稱(chēng)，如果在最后的一次按鍵是不支持的鍵，方法將返回undefined。除此之外，你還可以用lastKey判斷是否是某個(gè)特定的功能鍵被按下，它會(huì)要么返回true 要么返回 false。

受支持的按鍵
Kibo 支持下面的這些按鍵，拼寫(xiě)這些按鍵名時(shí)不區(qū)分大小寫(xiě)：

控制鍵 shift, ctrl, alt

字母鍵從a 到 z

數(shù)字鍵從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();

單鍵或多鍵組合

復(fù)制代碼代碼如下:

 
k.down(['up', 'down'], function() { 
console.log('up or down arrow key pressed'); 
}).up('tab', function() { 
console.log('TAB key released'); 
}); 

含有控制鍵的組合鍵

復(fù)制代碼代碼如下:

 
function handler() { 
console.log('last key: ' + k.lastKey()); 
} 

k.down(['shift q', 'ctrl alt x'], handler); 

通配符

復(fù)制代碼代碼如下:

 
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'); 
}); 

阻止缺省事件

復(fù)制代碼代碼如下:

k.down('f5', function() { return false; });

License
Kibo is released under the MIT License.

您可能感興趣的文章: