最近遇到一個很奇怪的 bug:一個按鈕點擊提交時,會發出好幾次請求,導致資料重複寫入。追查之後發現,問題出在 live() 身上。
當時的程式碼大致如下:
$("#id").live("click", function () {
// 送出表單
});
直覺的反應是改用 bind(),但這個方案達不到需求。原因是:當非同步請求回傳的是 HTML 片段而不是 JSON 時,我們會用這段 HTML 去刷新頁面的一部分(html() 或 append())。bind() 是直接綁在既有 DOM 元素上的,一旦元素被新的 HTML 取代,原本綁定的事件就跟著消失了,新產生的按鈕完全點不動。
這正是 live()(以及後來的 delegate()、on() 事件委派)被設計出來的原因:把事件監聽掛在祖先元素上,因此動態加入的後代元素也能被照顧到。
問題在於重複綁定。如果每次用 html() 刷新區塊時,程式又執行了一次 $("#id").live("click", ...),那麼同一個按鈕上就掛了多份處理器。點一次,就觸發 N 次請求。刷新幾次之後,N 就變成 3、4、5……
最後我直接在 HTML 標籤元素上寫 onclick 屬性來解決:
<button onclick="submitForm()">提交</button>
這樣既滿足了「非同步回傳 HTML 後按鈕仍可用」的需求,也避免了因為多次 html() 刷新(包含其中的 JS 部分)而重複綁定,導致一次點擊發出多個請求的 bug。
其實不必退回 inline 的 onclick,用 jQuery 的事件委派就能兼顧兩邊的優點。關鍵是:把監聽掛在不會被替換的祖先元素上,而且只綁一次。
// 綁在 document 上,只執行一次,不必在每次刷新後重綁
$(document).ready(function () {
$(document).on("click", "#submitBtn", function (e) {
e.preventDefault();
submitForm();
});
});
// 刷新內容時只換 HTML,不需要再處理事件
$("#container").html(newHtml);
$(document).on("click", "#submitBtn", handler) 的第三個參數是選擇器,代表「事件目標符合這個選擇器時才執行」。因為監聽器掛在 document 上,所以 #container 內容被整個替換後,新的 #submitBtn 一樣會被攔下來。
live() 在 jQuery 1.7 被標記為不建議使用,並在 jQuery 1.9 中正式移除。它的實作方式(每次呼叫都重新綁到 document)正是重複觸發的根源。現在請一律使用:
$(document).on("click", selector, handler) — 事件委派,適合動態元素$("#static").on("click", handler) — 直接綁定,適合靜態元素另外,若重複請求伴隨「送出後沒有 disable 按鈕」,建議加上防連點保護,這在網路慢時特別重要:
function submitForm() {
const $btn = $("#submitBtn").prop("disabled", true);
$.post("/api/save", getData())
.always(() => $btn.prop("disabled", false));
}