Event 物件代表事件的狀態:事件發生在哪個元素、鍵盤與滑鼠的狀態、游標位置等等。一旦事件觸發,瀏覽器記憶體中就會產生對應的 event 物件——例如點擊一個按鈕,便會產生相對應的物件。
有兩點前提要先記住:event 物件只在事件發生的過程中有效;而且它的某些屬性只對特定事件有意義,例如 fromElement 與 toElement 僅在 onmouseover 與 onmouseout 時才有意義。
完整屬性清單:altKey、button、cancelBubble、clientX、clientY、ctrlKey、fromElement、keyCode、offsetX、offsetY、propertyName、returnValue、screenX、screenY、shiftKey、srcElement、srcFilter、toElement、type、x、y。
檢查 alt 鍵狀態。語法 event.altKey,按下時為 true,否則 false,唯讀。
檢查按下的滑鼠鍵。語法 event.button,可能的值:0 未按鍵、1 左鍵、2 右鍵、3 左右鍵同時、4 中鍵、5 左鍵加中鍵、6 右鍵加中鍵、7 所有鍵。此屬性僅用於 onmousedown、onmouseup、onmousemove,其他事件不論滑鼠狀態一律回傳 0(例如 onclick)。
決定是否接受上層元素的事件控制。語法 event.cancelBubble[ = 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">
分別回傳滑鼠在視窗客戶區域中的 X 與 Y 座標。兩者皆為唯讀,只能讀取目前位置,無法用來移動滑鼠。
檢查 ctrl 鍵狀態。按下時 true,否則 false,唯讀。
在 onmouseover 與 onmouseout 期間,偵測滑鼠所離開的元素。唯讀,對照組是 toElement。
偵測鍵盤事件對應的內碼,用於 onkeydown、onkeyup、onkeypress。語法 event.keyCode[ = keyCode],可讀寫,值為任一 Unicode 鍵盤內碼;若未觸發鍵盤事件則為 0。
相對於觸發事件的物件,滑鼠位置的水平與垂直座標。
設定或回傳發生變化的屬性名稱。語法 event.propertyName[ = sProperty],可讀寫,無預設值,需搭配 onpropertychange 事件使用。
<HEAD>
<SCRIPT>
function changeProp() {
btnProp.value = "This is the new VALUE";
}
function changeCSSProp() {
btnStyleProp.style.backgroundColor = "aqua";
}
</SCRIPT>
</HEAD>
<BODY>
<P>The event object property propertyName is
used here to return which property has been
altered.</P>
<INPUT TYPE=button ID=btnProp onclick="changeProp()"
VALUE="Click to change the VALUE property of this button"
onpropertychange='alert(event.propertyName+" property has changed value")'>
<INPUT TYPE=button ID=btnStyleProp
onclick="changeCSSProp()"
VALUE="Click to change the CSS backgroundColor property of this button"
onpropertychange='alert(event.propertyName+" property has changed value")'>
</BODY>
設定或檢查從事件中回傳的值。語法 event.returnValue[ = Boolean]:true 表示事件中的值被回傳,false 表示取消來源物件上事件的預設動作。
偵測滑鼠相對於使用者螢幕的水平與垂直位置,皆為唯讀。
檢查 shift 鍵狀態,按下時 true,否則 false,唯讀。
回傳觸發事件的元素,唯讀。
回傳觸發 onfilterchange 事件的濾鏡,唯讀。
在 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>
回傳事件名稱,不含 on 前綴——例如 onclick 回傳的是 click。唯讀。
回傳滑鼠相對於「CSS 屬性中含有 position 的上層元素」的 x 與 y 軸座標;若無這樣的上層元素,則預設以 BODY 作為參考對象。事件觸發後滑鼠移出視窗時回傳 -1。兩者皆為唯讀。
實務提醒:以上多為 IE 的事件模型屬性。現代開發建議以標準事件物件為主,例如用 event.target 取代 srcElement、用 stopPropagation() 取代 cancelBubble、以 preventDefault() 取代 returnValue = false,座標則優先使用 clientX/clientY 搭配 pageX/pageY。