當使用者雙擊 DOM 物件(例如按鈕或連結)時,往往會造成非預期的重複觸發,這在互動設計上是個麻煩的問題。幸好 jQuery 提供了一個相當漂亮的解法——.one()。
它為元素附加一個事件處理器,但每個元素上的該處理器最多只會執行一次。
.one( events [, selector ] [, data ], handler(eventObject) )
規定要加到元素上的一個或多個事件,多個事件以空格分隔,必須是有效事件名稱,例如「click」或「keydown.myPlugin」。
用於過濾被選中元素中能觸發事件的子元素;若傳入 null 或省略,則事件到達選定元素時就會觸發。
事件觸發時會傳給事件處理函式的資料。
事件觸發時應呼叫的函式;傳入 false 也是允許的,等同於 return false; 的簡寫。
$("#saveBttn").one("click", function () {
alert("This will be displayed only once.");
});
或者:
$("body").one("click", "#saveBttn", function () {
alert("This displays if #saveBttn is the first thing clicked in the body.");
});
上述程式碼的關鍵在於:
• 當程式碼執行結束後,點擊 id 為 saveBtn 的元素會彈出警告框;
• 之後的點擊將不再有任何反應;
• 這等同於:
$("#saveBttn").on("click", function (event) {
alert("This will be displayed only once.");
$(this).off(event);
});
換句話說,這跟在綁定事件處理函式中顯式呼叫 off() 的效果是一樣的。
上面提到的方法是 jQuery 1.7 的新特性,所以如果你的元素點擊事件不希望被觸發多次,這可能就是最佳解法。是不是相當神奇呢?