event 物件只在事件處理的執行期間有效,一旦處理函式返回,它就不再可靠。更需要注意的是,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">
event 常用屬性包括:altKey、button、cancelBubble、clientX、clientY、ctrlKey、fromElement、keyCode、offsetX、offsetY、propertyName、returnValue、screenX、screenY、shiftKey、srcElement、srcFilter、toElement、type、x、y。
用來檢查對應修飾鍵的狀態,按下時為 true,否則為 false,三者皆為唯讀。常用於搭配點擊事件實作多重選取或快捷操作。
回報被按下的滑鼠鍵:0 未按、1 左鍵、2 右鍵、3 左右鍵同時、4 中鍵、5 左鍵+中鍵、6 右鍵+中鍵、7 全部按鍵。此屬性僅對 onmousedown、onmouseup、onmousemove 有意義;其他事件(例如 onclick)一律回傳 0。
可讀寫的布林值,用於阻斷事件冒泡。設為 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">
clientX、clientY 回傳滑鼠相對於瀏覽器視窗「客戶區」的座標;screenX、screenY 則是相對於整個螢幕的座標。四者皆為唯讀,只能讀取位置,無法用來移動滑鼠。實務上若要計算元素內部的相對位置,通常會再搭配 getBoundingClientRect 做減法。
滑鼠位置相對於觸發事件的那個元素本身的水平/垂直座標。實作自訂選單時特別有用,因為可以藉此判斷滑鼠落在父元素的哪個位置。
這兩個屬性只對 onmouseover 與 onmouseout 有效,分別代表滑鼠「離開的元素」與「進入的元素」。兩者皆為唯讀。範例如下:
<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。
搭配 onpropertychange 使用,取得或設定發生變化的屬性名稱,可讀寫且無預設值。範例:
<SCRIPT>
function changeProp() { btnProp.value = "This is the new value"; }
function changeCSSProp() { btnStyleProp.style.backgroundColor = "aqua"; }
</SCRIPT>
<BODY>
<INPUT TYPE=button ID=btnProp onclick="changeProp()"
value="Click to change the value property"
onpropertychange='alert(event.propertyName + " property has changed value")'>
<INPUT TYPE=button ID=btnStyleProp onclick="changeCSSProp()"
value="Click to change the CSS backgroundColor property"
onpropertychange='alert(event.propertyName + " property has changed value")'>
設定或檢查事件回傳值。true 表示事件值被回傳,false 表示取消來源物件上的預設行為。這是早期取消連結跳轉、表單提交最常見的做法。
srcElement 回傳觸發事件的元素(唯讀),是事件委派的核心;srcFilter 則回傳觸發 onfilterchange 的濾鏡物件。
回傳事件名稱,且不含 "on" 前綴。例如 onclick 事件的 type 是 click。唯讀。
回傳滑鼠相對於「具有 position 屬性的上層元素」的座標;若找不到這類上層元素,則以 BODY 為參考基準。事件觸發後滑鼠移出視窗時,值會是 -1。兩者皆為唯讀。
以上屬性屬於 IE 的事件模型。標準瀏覽器改用 W3C 的 event 參數傳遞方式,且對應名稱不同:srcElement → target、fromElement/toElement → relatedTarget、cancelBubble → stopPropagation()、returnValue = false → preventDefault()。撰寫現代程式時,請以標準 API 為主,把 IE 專屬寫法當成理解歷史與維護舊系統的背景知識。