剛開始學 jQuery Mobile 時,很容易寫出這樣的程式:
$(document).on("pageinit", function(){
$("XXX").bind()
})
看起來沒問題,實際跑起來卻發現同一個事件被觸發了做好幾次。
關鍵在於 pageinit 的觸發時機。jQuery Mobile 是單頁應用(SPA)思維:頁面之間的跳轉並非真的換頁,而是透過 AJAX 把新頁面的 DOM 插入當前文件。每插入一次,pageinit 就會觸發一次,而 $(document) 永遠是同一個物件——於是綁在裡面的 bind() 就被重複註冊了一次又一次。
換句話說,綁定的次數等於使用者造訪過的頁面數量,事件自然會觸發對應的次數。
把事件綁在穩定存在的祖先元素上,由它代為分發,這樣只綁一次即可:
$(document).on("pageinit", ".some-class", function(){
// 只註冊一次
});
更根本的做法是把綁定移出 pageinit,直接放在文件載入時執行一次:
$(function(){
$(document).on("click", ".my-button", function(e){
// delegation 寫法,對動態插入的元素也有效
});
});
若必須在 pageinit 中綁定,先 unbind 再 bind 是最直白的修補:
$(document).on("pageinit", function(){
$("XXX").unbind("click").bind("click", handler);
});
或用命名空間一次清乾淨:$("XXX").off(".myNs").on("click.myNs", handler)。命名空間在 jQuery 1.4.3 之後可用,是處理這類問題最精準的工具。
pageinit 會在每次頁面初始化時觸發;若你的程式只需要對「新插入的那個頁面」做事,可以從事件物件取得該頁:
$(document).on("pageinit", function(e){
var $page = $(e.target);
$page.find("XXX").on("click", handler);
});
因為作用在新插入的節點上,舊頁的綁定不會被重複加上。英文文件可參考 jQuery Mobile events firing multiple times 的說明。