框架提供的功能太齊全,反而容易踩坑。對工具庫依賴愈深,維護時一個看似微小的改動就可能波及不相關的功能——尤其是在接手多年前的遺留程式碼時。我最常看到的錯誤之一,就是關於 jQuery 的 trigger()。
trigger() 允許開發者手動觸發事件,這個能力確實強大好用。但請遵守一個約定:不要用它觸發 JavaScript 那些原生的名稱。(我知道其他框架也有類似機制,例如 MooTools 的 fireEvent(),問題本質相同,這裡只是拿 jQuery 當例子。)
// 監聽 click 事件
jQuery('.tabs a').on('click', function() {
// 切換面板、載入內容等等
});
// 在最後一個 a 上觸發 click
jQuery('.tabs a').last().trigger('click');
上面這段會切到指定 index 的頁籤。我完全理解為什麼有人這樣寫:要呼叫的函式在全域範圍內取不到,而「觸發事件」永遠是可行、隨手可得的手段。
麻 impossibility 之處在於,你觸發的是原生名稱,所以頁面上任何監聽同名事件的程式都會被驚動。看看網站其他地方可能出現的東西:
// 監聽 body 內部所有的 click
jQuery('body').on('click', 'a', function() {
// 一些業務邏輯 ...
// 若條件成立,就做別的事!
if (conditionMet) {
// 刷新頁面?
// 展開子選單?
// 提交表單?
// ……誰知道呢
}
});
於是頁籤的點擊被某個完全獨立的功能攔住了,而且難以察覺。這類 bug 最麻煩的點在於:出事的地方和寫下 trigger 的地方往往相隔很遠。
// 監聽 click 時,帶上自訂的事件名
jQuery('.tabs a').on('click tabs-click', function() {
// 切換 tab、載入內容……
});
// 觸發「假」事件
jQuery('.tabs a').last().trigger('tabs-click');
加上自己的命名空間之後,觸發器不會再和頁面上其他監聽器互相干擾。保守一點的建議是索性別用 trigger(),把要呼叫的邏輯抽成可存取的方法;但如果你還是要用,至少加上一個自訂事件名。
jQuery 的事件命名空間還能用在解除綁定上:.off('click.myModule') 只會移除你自己掛的那些監聽器,不會誤刪別人的。在多人協作或大量使用外掛的專案裡,這個習慣能省下不少追查時間。