以下方法都收攏在一個 EventUtil 物件中,以物件字面值的方式定義,方便直接取用。
① 新增事件
addHandler: function (element, type, handler) {
if (element.addEventListener) { // DOM2 級方法
element.addEventListener(type, handler, false);
} else if (element.attachEvent) { // IE 專屬
element.attachEvent("on" + type, handler);
} else { // DOM0 級,最後的退路
element["on" + type] = handler;
}
}
② 移除事件
removeHandler: function (element, type, handler) {
if (element.removeEventListener) {
element.removeEventListener(type, handler, false);
} else if (element.detachEvent) {
element.detachEvent("on" + type, handler);
} else {
element["on" + type] = null;
}
}
③ 取得事件物件與事件目標
// 取得事件物件的相容寫法
getEvent: function (event) {
return event ? event : window.event;
},
// 取得事件目標的相容寫法
getTarget: function (event) {
return event.target || event.srcElement;
}
④ 阻止預設行為
preventDefault: function (event) {
if (event.preventDefault) {
event.preventDefault();
} else {
event.returnValue = false;
}
}
⑤ 阻止事件氣泡
stopPropagation: function (event) {
if (event.stopPropagation) {
event.stopPropagation();
} else {
event.cancelBubble = true;
}
}
⑥ 取得mouseover/mouseout 的相關元素
getRelatedTarget: function (event) {
if (event.relatedTarget) {
return event.relatedTarget;
} else if (event.toElement) {
return event.toElement;
} else if (event.fromElement) {
return event.fromElement;
} else {
return null;
}
}
⑦ 滑鼠按鍵判斷
對 mousedown 與 mouseup 而言,event 物件上有 button 屬性。DOM 的定義是:0 為主鍵(左鍵)、1 為中鍵(滾輪)、2 為次鍵(右鍵)。IE8 及更早版本的 button 數值編法完全不同:0 表示未按下、1 為主鍵、2 為次鍵、3 為主次同時、4 為中鍵、5 為主+中、6 為次+中、7 為三鍵同時。
getButton: function (event) {
if (document.implementation.hasFeature("MouseEvents", "2.0")) {
return event.button;
} else {
switch (event.button) {
case 0: case 1: case 3: case 5: case 7:
return 0;
case 2: case 6:
return 2;
case 4:
return 1;
}
}
}
⑧ 取得滾輪增量值(delta)
getWheelDelta: function (event) {
if (event.wheelDelta) {
return (client.engine.opera && client.engine.opera < 9.5 ? -event.wheelDelta : event.wheelDelta);
} else {
return -event.detail * 40; // Firefox 中 +3 表示向上滾,-3 表示向下滾
}
}
⑨ 跨瀏覽器取得字元編碼
getCharCode: function (event) {
if (typeof event.charCode == "number") {
return event.charCode;
} else {
return event.keyCode;
}
}
⑩ 讀取剪貼簿
getClipboardText: function (event) {
var clipboardData = (event.clipboardData || window.clipboardData);
return clipboardData.getData("text");
}
⑪ 寫入剪貼簿
setClipboardText: function (event, value) {
if (event.clipboardData) {
return event.clipboardData.setData("text/plain", value);
} else if (window.clipboardData) {
return window.clipboardData.setData("text", value);
}
}
把這些方法包成一個工具物件,各處直接呼叫即可。歸納起來,這十一式的共同套路都是「先偵測標準 API,再退回專屬 API」;而今日的專案裡,除了剪貼簿需要 navigator.clipboard 這類仍需判斷權限的新 API,其餘大部分差異早已被標準化抹平。這份清單真正的用處,是當你閱讀老程式碼時能快速辨認每一段判斷在處理什麼。
完整檔案與更多 CSS、LESS 基礎重置樣式可參考作者整理的 resetFile 專案。