DIV CSS 佈局教程網

JavaScript window.event 事件物件屬性全解析
編輯:JavaScript基礎知識     

寫程式時要用到 window.event,上網查資料找到一篇整理得相當完整的說明,這裡重新編排並補充現代寫法,作為一份可查的參考。

event 是什麼

event 物件代表事件的狀態,例如觸發事件的元素、滑鼠的位置與按下的按鍵等。它有兩個重要特性:只在事件發生的過程中有效;部分屬性只對特定事件有意義,例如 fromElement 與 toElement 只在 onmouseover、onmouseout 時才有意義。

在舊版 IE 中,事件物件挂在 window.event 上;標準瀏覽器則是把它當參數傳給事件處理器。跨瀏覽器時通常這樣寫:

function handler(event) {
  event = event || window.event;
  // ...
}

常用範例

檢查滑鼠是否在連結上點擊,若同時按下了 Shift 就取消跳轉:

<script language="JScript">
function cancelLink() {
  if (window.event.srcElement.tagName === 'A' && window.event.shiftKey) {
    window.event.returnValue = false;
  }
}
</script>
<BODY onclick="cancelLink()">

在狀態列顯示滑鼠目前位置:

<BODY onmousemove="window.status = 'X=' + window.event.x + ' Y=' + window.event.y">

屬性清單與說明

altKey/ctrlKey/shiftKey

檢查 Alt、Ctrl、Shift 鍵的狀態。按下的瞬間值為 true,否則為 false,唯讀。

button

檢查按下的滑鼠鍵:0 未按鍵、1 左鍵、2 右鍵、3 左右鍵同時、4 中鍵、5 左鍵+中鍵、6 右鍵+中鍵、7 全部。僅用於 onmousedown、onmouseup、onmousemove,其他事件一律回傳 0(例如 onclick)。

cancelBubble

可讀寫的布林值,用來控制事件是否往父元素傳遞。設為 true 表示不再受上層元素的事件控制,false(預設值)則允許冒泡。範例:在圖片上點擊時若同時按了 Shift,就取消 body 上 onclick 觸發的 showSrc()。

<script language="JScript">
function checkCancel() {
  if (window.event.shiftKey) { window.event.cancelBubble = true; }
}
function showSrc() {
  if (window.event.srcElement.tagName === 'IMG') {
    alert(window.event.srcElement.src);
  }
}
</script>
<BODY onclick="showSrc()">
<IMG onclick="checkCancel()" src="/sample.gif">

標準寫法對應的是 event.stopPropagation()。

clientX/clientY

滑鼠相對於瀏覽器視窗客戶區的 X、Y 座標,唯讀。注意捲動頁面後,clientY 不會隨之改變,若需要文件座標要再加上 document.documentElement.scrollTop。

fromElement/toElement

在 onmouseover 與 onmouseout 事件中,fromElement 是滑鼠離開的元素,toElement 是滑鼠進入的元素,皆為唯讀。標準寫法對應 relatedTarget。

<script>
function testMouse(oObject) {
  if (oObject.contains(event.toElement)) {
    alert("mouse arrived");
  }
}
</script>
<BUTTON ID=oButton onmouseover="testMouse(this)">Mouse Over This.</BUTTON>

keyCode

鍵盤事件對應的內碼,用於 onkeydown、onkeyup、onkeypress。可讀寫,可以是任何 Unicode 鍵盤內碼,若無引發鍵盤事件則為 0。

offsetX/offsetY

滑鼠相對於觸發事件元素本身的水平、垂直座標。要注意邊框不算在內,且子元素的座標會相對該子元素計算,實務上不如 clientX 搭配 getBoundingClientRect 好掌握。

propertyName

設定或回傳發生變化的屬性名稱,可讀寫,無預設值。需搭配 onpropertychange 事件使用,是 IE 專屬的屬性變更監聽機制。

<script>
function changeProp() { btnProp.value = "This is the new VALUE"; }
function changeCSSProp() { btnStyleProp.style.backgroundColor = "aqua"; }
</script>
<INPUT TYPE=button ID=btnProp onclick="changeProp()"
  onpropertychange='alert(event.propertyName + " property has changed value")'>

returnValue

設定或檢查從事件中回傳的值。設為 true 表示事件中的值被回傳,設為 false 則取消來源物件上該事件的預設動作。標準寫法是 event.preventDefault()。

screenX/screenY

滑鼠相對於使用者整個螢幕的水平、垂直位置,唯讀。多螢幕環境下要注意座標可能為負。

srcElement

回傳觸發事件的元素,唯讀。標準寫法為 event.target。

srcFilter

回傳觸發 onfilterchange 事件的濾鏡物件,唯讀。這是 IE 專屬的 DirectX 濾鏡機制,現已無實用價值。

type

回傳事件名稱,不含 "on" 前綴——例如 onclick 事件的 type 是 click。唯讀。

x/y

滑鼠相對於「CSS 屬性中設有 position 的上層元素」的座標;若無這樣的上層元素,則預設以 BODY 為參考點。若事件觸發後滑鼠移出視窗外,回傳 −1。唯讀。

IE 專屬屬性的現代對照

把上面這些屬性攤開來看,可以清楚看到早期 IE 與標準的差異。整理如下:

srcElement → target

fromElement / toElement → relatedTarget

cancelBubble = true → stopPropagation()

returnValue = false → preventDefault()

x / y → pageX / pageY 或 clientX / clientY

attachEvent → addEventListener

其中 window.status 這種狀態列寫法,現代瀏覽器基於安全考量多半會直接忽略,不該再用於顯示資訊。

一個跨瀏覽器的取值範例

document.addEventListener('click', function (e) {
  var target = e.target;
  var x = e.clientX;
  var y = e.clientY;
  console.log(target.tagName, x, y, e.type);
  // 需要阻止預設行為時
  e.preventDefault();
  // 需要阻止冒泡時
  e.stopPropagation();
});

總結來說,window.event 這套寫法屬於 IE 的歷史遺產。理解它的屬性對照,有助於閱讀與維護舊程式碼;但新專案一律應使用標準事件模型,把事件物件當參數接收,並用 addEventListener 註冊。

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