事件註冊看起來是再簡單不過的事,但從「寫在標籤上」一路走到「跨瀏覽器封裝」,中間每一步其實都在解決前一步留下的問題。這段演進過程很適合當作理解前端架構思維的教材。
<p id="para" title="cssrain demo!" onclick="test()">test</p>
<script>
function test() {
alert("test");
}
</script>
最直接,也最糟。行為與結構糾纏在一起,同一段邏輯有多個觸發點時到處都是重複標記,而且 inline 事件在實施內容安全政策(CSP)時會被直接封鎖。
<p id="para" title="cssrain demo!">test</p>
<script>
function test() {
alert("test");
}
window.onload = function () {
document.getElementById("para").onclick = test;
};
</script>
行為被移到腳本中,標籤乾淨了。注意這裡的關鍵細節:onclick = test 而非 onclick = test()。加上括號會變成立即呼叫,把回傳值指派給 onclick,事件永遠不會觸發。這個錯誤幾乎每個人都犯過。
<p id="para" title="cssrain demo!">test</p>
<script>
function test() { alert("test"); }
function pig() { alert("pig"); }
window.onload = function () {
document.getElementById("para").onclick = test;
document.getElementById("para").onclick = pig;
};
</script>
指派式註冊是「覆蓋」語意,第二次指派會把第一次的處理函式整個丟掉,結果只會跳出一個 pig。要註冊多個,就需要 attachEvent。
<script>
window.onload = function () {
document.getElementById("para").attachEvent("onclick", test);
document.getElementById("para").attachEvent("onclick", pig);
};
</script>
這段碼在 IE 上運作良好,兩個函式都會被呼叫。但一旦丟進 Firefox,它完全不動——因為 attachEvent 是 IE 專屬,且事件名稱必須帶 "on" 前綴。此外它還有兩個更棘手的問題:this 會指向 window 而非觸發事件的元素,以及註冊順序與宣告順序相反。
<script>
window.onload = function () {
var element = document.getElementById("para");
if (element.addEventListener) { // Firefox、W3C 標準
element.addEventListener("click", test, false);
element.addEventListener("click", pig, false);
} else { // IE
element.attachEvent("onclick", test);
element.attachEvent("onclick", pig);
}
};
</script>
標準環境用 addEventListener,事件名不帶 on,第三個參數控制是否使用捕獲階段;IE 則走 attachEvent。兩邊都支援同一元素註冊多個同型事件,且 this 指向正確。這段程式終於可以在多平台運作。
每次都要寫 if...else 太囉嗦,於是把判斷收進一個函式:
<script>
function addListener(element, e, fn) {
if (element.addEventListener) {
element.addEventListener(e, fn, false);
} else {
element.attachEvent("on" + e, fn);
}
}
window.onload = function () {
var element = document.getElementById("para");
addListener(element, "click", test);
addListener(element, "click", pig);
};
</script>
至此,從最傳統的 inline 寫法出發,經歷了行為分離、多重註冊、相容性處理,最後收斂成一個可重複呼叫的工具函式。
現在所有主流瀏覽器都支援 addEventListener 與 removeEventListener,attachEvent 只存在於極度老舊的 IE。因此上面的相容分支已無必要,但封裝的思路依然正確——把跨環境差異集中在一處,而不是散落在每個呼叫點。
若要再往前一步,可以考慮:為 addListener 加上對應的 removeListener(否則元件銷毀時會殘留事件,造成記憶體洩漏);支援事件委派,讓容器代為處理子元素事件;或者提供 once、passive 等選項的統一入口。這正是現代事件系統(如 React 的 SyntheticEvent、Vue 的事件 API)在背後做的事:把實作細節封裝起來,讓呼叫方只關心「什麼時候做什麼」。