萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery Event 事件對象屬性完整速查手冊

事件對象標準化

jQuery 將瀏覽器原生事件物件包裝為 jQuery.Event,統一跨瀏覽器差異,提供一致屬性與方法。

核心屬性速查表

屬性類型說明範例值
typeString事件類型"click", "keydown"
targetElement觸發事件的原始元素<a href="...">
currentTargetElement綁定事件處理器的元素(等同 this)<div class="box">
pageX / pageYNumber相對文檔左上角座標(含捲軸)1200, 450
clientX / clientYNumber相對視窗可視區座標800, 300
screenX / screenYNumber相對螢幕實體座標1920, 540
whichNumber鍵碼/滑鼠鍵:1=左鍵, 2=中鍵, 3=右鍵13 (Enter)
keyCode (已棄用)Number鍵盤碼,現代用 key/code65 ('A')
altKey / ctrlKey / shiftKey / metaKeyBoolean修飾鍵狀態true/false
relatedTargetElement相關元素(mouseover 來源、mouseout 目標)<div>
dataAny綁定時傳遞的額外數據 .on('click', data, fn){id: 1}
namespaceString事件命名空間"validate.form"
timeStampNumber事件發生時間戳 (ms)1703123456789

關鍵方法

方法作用
preventDefault()阻止預設行為(如連結跳轉、表單提交)
stopPropagation()阻止事件冒泡
stopImmediatePropagation()阻止冒泡並阻止同元素其他處理器執行
isDefaultPrevented()檢查是否已調用 preventDefault
isPropagationStopped()檢查是否已調用 stopPropagation

實戰範例

1. 獲取事件類型

$('a').click(function(e) {
    console.log(e.type); // "click"
    e.preventDefault();  // 阻止跳轉
});

2. 獲取目標元素屬性

$('a[href="https://google.com"]').click(function(e) {
    console.log(e.target.href); // "https://google.com/"
    return false; // 等同 preventDefault + stopPropagation
});

3. 滑鼠座標

$(document).click(function(e) {
    console.log(`頁面座標: ${e.pageX}, ${e.pageY}`);
    console.log(`視窗座標: ${e.clientX}, ${e.clientY}`);
});

4. 滑鼠按鍵判斷

$(document).mousedown(function(e) {
    switch(e.which) {
        case 1: console.log('左鍵'); break;
        case 2: console.log('中鍵/滾輪'); break;
        case 3: console.log('右鍵'); break;
    }
});

5. 鍵盤碼速查(常用)

// 現代建議使用 e.key / e.code
const KEY = {
    ENTER: 13, ESC: 27, SPACE: 32, TAB: 9,
    LEFT: 37, UP: 38, RIGHT: 39, DOWN: 40,
    SHIFT: 16, CTRL: 17, ALT: 18
};

// 獲取 keyCode(兼容舊代碼)
$('input').keyup(function(e) {
    console.log(e.which); // 等同 e.keyCode
});

結語

熟悉 jQuery Event 統一屬性,能跨瀏覽器一致處理事件資訊。現代開發建議直接使用原生 event(已高度標準化),僅在需 jQuery 專有功能(如 data、namespace)時使用包裝物件。

copyright © 萬盛學電腦網 all rights reserved