小型專案裡大概不會用到自訂事件,但如果是多人協作的中大型專案,它的重要性會突然浮現。這篇從一個常見的協作衝突講起,再談參數傳遞與多綁定的實作。
前端開發者 A 先寫了一個函式:
function move() {
alert(a); // 這裡代表 N 行程式碼
}
過一陣子,B 要在 A 的基礎上補功能,於是直接改:
function move() {
alert(a); // A 的程式碼
alert(b); // B 新增的程式碼
}
又過一陣子,C 也來補:
function move() {
alert(a); // A 的程式碼
alert(b); // B 的程式碼
alert(c); // C 新增的程式碼
}
問題浮現了:後加入的人必須先讀懂前面所有的程式碼、避開命名衝突、還要小心不要弄壞別人的邏輯。人一多,這段程式碼就成了誰都不太敢碰的公共財。
關鍵觀察是:同一個元素上可以掛多個同類事件,彼此不會互相覆蓋。
window.addEventListener('click', function () {
alert(1);
}, false);
window.addEventListener('click', function () {
alert(2);
}, false);
點擊時,1 和 2 都會跳出來。既然 click 可以這樣,那麼 move 也可以——只要它是一個自訂事件名稱:
window.addEventListener('move', function () {
alert(3);
}, false);
window.addEventListener('move', function () {
alert(4);
}, false);
接著觸發它:
var event = new Event('move');
window.dispatchEvent(event); // 3 和 4 都會執行
這裡的 move 就是自訂事件。A、B、C 各自註冊自己的 listener,誰都不用改別人的程式碼,也不必擔心命名衝突。這就是自訂事件在協作場景下的價值:把「修改同一段程式碼」變成「各自訂閱同一個訊號」。
事件機制本身只傳事件物件,不直接帶入自訂參數。傳統解法是「反過來想」:不糾結如何把參數塞進去,而是包一層不需要參數的外殼,把參數事先存在閉包里。
// 將帶參數的函式包裝成無參數的函式
function createFunction(obj, strFunc) {
var args = []; // 用來保存要傳給事件處理器的參數
if (!obj) obj = window; // 若是全域函式則 obj = window
for (var i = 2; i < arguments.length; i++) args.push(arguments[i]);
return function () {
obj[strFunc].apply(obj, args); // 透過 apply 把參數帶進去
};
}
function class1() {
}
class1.prototype = {
show: function () {
this.onShow();
},
onShow: function () { }
};
function objOnShow(userName) {
alert("hello, " + userName);
}
function test() {
var obj = new class1();
var userName = "test";
obj.onShow = createFunction(null, "objOnShow", userName);
obj.show();
}
核心技巧是 apply:它把一個陣列展開成呼叫時的參數列表,於是原本需要參數的函式就能被無參數的外殼安全地呼叫。
把處理器收集成陣列,觸發時逐一執行:
class1.prototype = {
show: function () {
if (this.onShow) {
for (var i = 0; i < this.onShow.length; i++) {
this.onShow[i]();
}
}
},
attachOnShow: function (_eHandler) { // 附加事件
if (!this.onShow) { this.onShow = []; }
this.onShow.push(_eHandler);
},
detachOnShow: function (_eHandler) { // 移除事件
if (!this.onShow) { this.onShow = []; }
this.onShow.pop(_eHandler);
}
};
function test() {
var obj = new class1();
obj.attachOnShow(createFunction(null, "objOnShow", "your name"));
obj.attachOnShow(createFunction(null, "objOnShow2", "test message"));
obj.show();
}
attachOnShow 的基本思想就是陣列的 push。最後還能再包一個 detachOnShow,讓事件執行完畢後移除處理器,避免重複觸發。
上面這套手工實作,在支援 DOM 的環境裡其實有更簡潔的選擇:
obj.addEventListener('show', function (e) {
alert(e.detail.userName);
});
obj.dispatchEvent(new CustomEvent('show', { detail: { userName: "test" } }));
CustomEvent 的 detail 屬性天生就是為了攜帶自訂資料而設計的,不必再靠 apply 繞路;removeEventListener 也能精準移除指定的處理器,比 pop() 可靠得多。
理解前段的原理仍然有價值——它說明了「事件」本質上就是「一組被註冊的函式,在時機到來時被逐一呼叫」。這個模型不只存在於 DOM,Node.js 的 EventEmitter、Vue 的 $emit、各家 UI 框架的元件通訊,打的都是同一套地基。