有些互動天生就該只發生一次,例如首次點擊時播放的引導動畫、只跳一次的歡迎提示,或是「同意條款」後就不再出現的公告。若用一般的 on() 或 click() 綁定,每次點擊都會重複觸發,這時 one() 方法就非常合用。
$(document).ready(function(){
$("p, h1, h2").one("click", function(){
$(this).animate({fontSize:"+=3px"});
});
});
對應的 HTML 很單純:
<h1>這是一個標題</h1> <h2>這是另一個標題</h2> <p>這是一個段落</p>
執行後,每個元素被點擊的第一次會放大字級;第二次之後再怎麼點都不會有任何反應,因為 one() 在函式執行完的同時就把自己從事件佇列中移除了。
$(selector).one(event, data, handler)
click。one() 支援的事件類型與 on() 完全一致,也可以搭配命名空間與委派語法使用。值得一提的是,事件委派寫法同樣適用:
$(document).one("click", ".btn", function(){ /* ... */ });
這裡的行為是「整個 document 上符合 .btn 的點擊只會被處理一次」,而不是每個按鈕各自一次,使用時要特別留意這個差異。
除了引導動畫,one() 也很適合處理一次性的初始化程序:例如第一次聚焦時才載入建議清單、首次捲動時才插入廣告。相比自己在 handler 裡寫 off() 手動解綁,one() 的意圖更清楚,程式碼也更乾淨。