jQuery 將瀏覽器原生事件物件包裝為 jQuery.Event,統一跨瀏覽器差異,提供一致屬性與方法。
| 屬性 | 類型 | 說明 | 範例值 |
|---|---|---|---|
type | String | 事件類型 | "click", "keydown" |
target | Element | 觸發事件的原始元素 | <a href="..."> |
currentTarget | Element | 綁定事件處理器的元素(等同 this) | <div class="box"> |
pageX / pageY | Number | 相對文檔左上角座標(含捲軸) | 1200, 450 |
clientX / clientY | Number | 相對視窗可視區座標 | 800, 300 |
screenX / screenY | Number | 相對螢幕實體座標 | 1920, 540 |
which | Number | 鍵碼/滑鼠鍵:1=左鍵, 2=中鍵, 3=右鍵 | 13 (Enter) |
keyCode (已棄用) | Number | 鍵盤碼,現代用 key/code | 65 ('A') |
altKey / ctrlKey / shiftKey / metaKey | Boolean | 修飾鍵狀態 | true/false |
relatedTarget | Element | 相關元素(mouseover 來源、mouseout 目標) | <div> |
data | Any | 綁定時傳遞的額外數據 .on('click', data, fn) | {id: 1} |
namespace | String | 事件命名空間 | "validate.form" |
timeStamp | Number | 事件發生時間戳 (ms) | 1703123456789 |
| 方法 | 作用 |
|---|---|
preventDefault() | 阻止預設行為(如連結跳轉、表單提交) |
stopPropagation() | 阻止事件冒泡 |
stopImmediatePropagation() | 阻止冒泡並阻止同元素其他處理器執行 |
isDefaultPrevented() | 檢查是否已調用 preventDefault |
isPropagationStopped() | 檢查是否已調用 stopPropagation |
$('a').click(function(e) {
console.log(e.type); // "click"
e.preventDefault(); // 阻止跳轉
});
$('a[href="https://google.com"]').click(function(e) {
console.log(e.target.href); // "https://google.com/"
return false; // 等同 preventDefault + stopPropagation
});
$(document).click(function(e) {
console.log(`頁面座標: ${e.pageX}, ${e.pageY}`);
console.log(`視窗座標: ${e.clientX}, ${e.clientY}`);
});
$(document).mousedown(function(e) {
switch(e.which) {
case 1: console.log('左鍵'); break;
case 2: console.log('中鍵/滾輪'); break;
case 3: console.log('右鍵'); break;
}
});
// 現代建議使用 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)時使用包裝物件。