在 keydown 事件中取得被按下的按鍵:
$("input").keydown(function(event){
$("div").html("Key: " + event.which);
});
event.which
用來表示被按下的是哪個按鍵或滑鼠鍵。event 參數為必填,來自事件綁定函數。
原生瀏覽器的按鍵資訊並不統一:鍵盤方面,IE 使用 keyCode,Firefox 使用 charCode;滑鼠方面,標準的 button 屬性以 0、1、2 代表左、中、右鍵。jQuery 放棄標準的 button 而改用 which,多少讓人費解,但目的是提供一致的介面。
which 原本是 Firefox 引入的屬性,用來取得鍵盤的鍵值。jQuery 把它擴充成「鍵盤與滑鼠通用」:判斷使用者按了哪個鍵時可用,判斷按了哪個滑鼠鍵時也可用。這也是原始碼中那兩段補充邏輯的由來:
// 為 key event 補上 which
if ( event.which == null && (event.charCode != null || event.keyCode != null) ) {
event.which = event.charCode != null ? event.charCode : event.keyCode;
}
// 為 click 補上 which:1 = 左鍵;2 = 中鍵;3 = 右鍵
if ( !event.which && event.button !== undefined ) {
event.which = (event.button & 1 ? 1 : ( event.button & 2 ? 3 : ( event.button & 4 ? 2 : 0 ) ));
}
對照如下:標準 button 以 0、1、2 表示左中右,而 jQuery 的 which 則是 1、2、3。
官方文件在說明 event.which 時只提到鍵盤鍵值,並未提及它也能表示滑鼠按鍵,原始碼註釋同樣容易誤導——註釋寫的是「為 click 補上 which」,很容易讓人以為在 click 事件中就能正確取值。
實際測試如下:
<script>
$(document).click(function(e){
alert(e.which);
});
</script>
結果並不符合預期。原因是 click 事件本身只會由左鍵觸發,而 which 在這個情境下取值依瀏覽器而異,並不可靠。
要判斷滑鼠左右鍵,請改用 mousedown 事件,此時 which 才會穩定地回傳 1(左)、2(中)、3(右):
$(document).mousedown(function(e){
if (e.which === 1) console.log('左鍵');
if (e.which === 2) console.log('中鍵');
if (e.which === 3) console.log('右鍵');
});
若只區分「是否為左鍵」,更直覺的寫法是用 e.button === 0;至於鍵盤,新專案建議改用標準的 e.key,可讀性遠高於記誦 keycode 數字。