滑鼠事件的 button 屬性在 W3C 標準與舊版 IE 中定義不同,導致跨瀏覽器判斷左/中/右鍵極易出錯。本文提供標準化封裝函式,支援現代瀏覽器與 IE9+。
| 按鍵 | W3C 標準 e.button | IE8- window.event.button |
|---|---|---|
| 左鍵 | 0 | 1 |
| 中鍵/滾輪 | 1 | 4 |
| 右鍵 | 2 | 2 |
| 無按鍵/移動 | - | 0 |
/**
* 取得標準化滑鼠按鍵代碼 (0=左, 1=中, 2=右)
* @param {MouseEvent} e - 事件物件
* @returns {number|null} 標準化按鍵代碼,非滑鼠事件回傳 null
*/
function getMouseButton(e) {
e = e || window.event; // IE 相容
// 現代瀏覽器直接回傳 W3C 標準值
if (typeof e.button === 'number') {
return e.button;
}
// IE8- 透過 window.event.button 轉換
const iev = window.event && window.event.button;
if (typeof iev === 'number') {
switch (iev) {
case 1: return 0; // 左鍵
case 4: return 1; // 中鍵
case 2: return 2; // 右鍵
default: return null;
}
}
return null;
}
// 使用範例
document.addEventListener('mousedown', function(e) {
const btn = getMouseButton(e);
if (btn === 0) console.log('左鍵');
else if (btn === 1) console.log('中鍵');
else if (btn === 2) console.log('右鍵');
});
event.buttons(位元遮罩)W3C 另定義 buttons 屬性(注意複數),為**位元遮罩**,可同時偵測多鍵按下:
| 值 | 按鍵組合 |
|---|---|
| 1 | 左鍵 |
| 2 | 右鍵 |
| 4 | 中鍵 |
| 3 | 左+右 |
| 5 | 左+中 |
| 7 | 左+中+右 |
// 現代寫法:支援多鍵同時按下
element.addEventListener('mousedown', e => {
if (e.buttons & 1) console.log('左鍵按下');
if (e.buttons & 2) console.log('右鍵按下');
if (e.buttons & 4) console.log('中鍵按下');
});
支援度: IE11+、Edge、Chrome、Firefox、Safari 全支援。IE9-10 僅支援 button。
// 阻止預設右鍵選單
element.addEventListener('contextmenu', e => e.preventDefault());
// 自訂右鍵選單
element.addEventListener('contextmenu', e => {
e.preventDefault();
showCustomMenu(e.clientX, e.clientY);
});
// 事件物件關鍵屬性
e.clientX / e.clientY // 視窗座標
e.pageX / e.pageY // 頁面座標(含捲軸)
e.screenX / e.screenY // 螢幕座標
e.offsetX / e.offsetY // 相對目標元素內部座標
e.which // 非標準,同 button(jQuery 正規化用)
e.buttons // 位元遮罩(現代標準)
e.button (單鍵) 或 e.buttons (多鍵),IE11+ 完整支援。getMouseButton() 封裝。event.which 已正規化為 W3C 值,可直接使用。統一滑鼠按鍵判斷邏輯,能避免跨瀏覽器 Bug,提升互動功能的可靠度。