寫程式時要用到 window.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">
檢查 Alt、Ctrl、Shift 鍵的狀態。按下的瞬間值為 true,否則為 false,唯讀。
檢查按下的滑鼠鍵:0 未按鍵、1 左鍵、2 右鍵、3 左右鍵同時、4 中鍵、5 左鍵+中鍵、6 右鍵+中鍵、7 全部。僅用於 onmousedown、onmouseup、onmousemove,其他事件一律回傳 0(例如 onclick)。
可讀寫的布林值,用來控制事件是否往父元素傳遞。設為 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()。
滑鼠相對於瀏覽器視窗客戶區的 X、Y 座標,唯讀。注意捲動頁面後,clientY 不會隨之改變,若需要文件座標要再加上 document.documentElement.scrollTop。
在 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>
鍵盤事件對應的內碼,用於 onkeydown、onkeyup、onkeypress。可讀寫,可以是任何 Unicode 鍵盤內碼,若無引發鍵盤事件則為 0。
滑鼠相對於觸發事件元素本身的水平、垂直座標。要注意邊框不算在內,且子元素的座標會相對該子元素計算,實務上不如 clientX 搭配 getBoundingClientRect 好掌握。
設定或回傳發生變化的屬性名稱,可讀寫,無預設值。需搭配 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")'>
設定或檢查從事件中回傳的值。設為 true 表示事件中的值被回傳,設為 false 則取消來源物件上該事件的預設動作。標準寫法是 event.preventDefault()。
滑鼠相對於使用者整個螢幕的水平、垂直位置,唯讀。多螢幕環境下要注意座標可能為負。
回傳觸發事件的元素,唯讀。標準寫法為 event.target。
回傳觸發 onfilterchange 事件的濾鏡物件,唯讀。這是 IE 專屬的 DirectX 濾鏡機制,現已無實用價值。
回傳事件名稱,不含 "on" 前綴——例如 onclick 事件的 type 是 click。唯讀。
滑鼠相對於「CSS 屬性中設有 position 的上層元素」的座標;若無這樣的上層元素,則預設以 BODY 為參考點。若事件觸發後滑鼠移出視窗外,回傳 −1。唯讀。
把上面這些屬性攤開來看,可以清楚看到早期 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 註冊。