DIV CSS 佈局教程網

understanding jQuery 的 event.which:同時取得鍵盤與滑鼠按鍵值
編輯:JQuery特效代碼     

基本用法

在 keydown 事件中取得被按下的按鍵:

$("input").keydown(function(event){
    $("div").html("Key: " + event.which);
});

規格

event.which

用來表示被按下的是哪個按鍵或滑鼠鍵。event 參數為必填,來自事件綁定函數。

為什麼 jQuery 要用 which

原生瀏覽器的按鍵資訊並不統一:鍵盤方面,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 數字。

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