DIV CSS 佈局教程網

jQuery live 的綁定陷阱:一次點擊觸發多次請求怎麼解
編輯:JavaScript綜合知識     

最近遇到一個很奇怪的 bug:一個按鈕點擊提交時,會發出好幾次請求,導致資料重複寫入。追查之後發現,問題出在 live() 身上。

問題現場

當時的程式碼大致如下:

$("#id").live("click", function () {
  // 送出表單
});

為什麼不能改用 bind

直覺的反應是改用 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 已被移除

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));
}
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved