萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 事件冒泡實作點擊空白區域關閉 Modal:stopPropagation 與 one() 最佳實踐

問題場景

點擊按鈕開啟 Modal,點擊 Modal 內容區**不關閉**,點擊 Modal **外部空白區域**才關閉。若直接在 `document` 綁定 click 關閉,按鈕點擊會冒泡觸發關閉,導致 Modal 閃現即消失。

錯誤示範

// ❌ 錯誤:按鈕點擊冒泡到 document,Modal 立即關閉
$("#btn").on("click", function () { $("#modal").show(); });
$(document).on("click", function () { $("#modal").hide(); });

正確方案:Modal 內阻止冒泡 + document 一次性監聽

// 1. Modal 內容區阻止冒泡
$("#modal").on("click", function (e) {
  e.stopPropagation(); // 關鍵:事件不再向上傳遞
});

// 2. document 使用 one():點擊一次後自動解綁
$("#btn").on("click", function (e) {
  e.stopPropagation(); // 按鈕點擊也不冒泡
  $("#modal").show();

  // 只監聽下一次 document click
  $(document).one("click", function (e) {
    // 此時 e.target 不會是 #modal 內部元素(因已阻止冒泡)
    $("#modal").hide();
  });
});

為什麼用 .one() 而非 .on()?

  • .one() 觸發後**自動移除監聽器**,避免疊加多層關閉邏輯。
  • Modal 關閉後,下一次開啟會重新註冊,邏輯乾淨。

進階:ES6 類別封裝可復用 Modal

class Modal {
  constructor(triggerSel, modalSel) {
    this.$trigger = $(triggerSel);
    this.$modal = $(modalSel);
    this.bind();
  }

  bind() {
    this.$trigger.on("click", (e) => {
      e.stopPropagation();
      this.open();
    });
    this.$modal.on("click", (e) => e.stopPropagation());
  }

  open() {
    this.$modal.show();
    // 使用 one 確保只關閉一次
    $(document).one("click", () => this.close());
  }

  close() {
    this.$modal.hide();
  }
}

// 使用
new Modal("#btn", "#modal");

替代方案:點擊遮罩層關閉(更直覺)

<div class="modal-overlay">
  <div class="modal-content">...</div>
</div>

.modal-overlay { position:fixed; inset:0; background:rgba(0,0,0,.5); display:none; }
.modal-content { position:absolute; top:50%; left:50%; transform:translate(-50%,-50%); }

$(".modal-overlay").on("click", function (e) {
  if (e.target === this) $(this).hide(); // 僅點擊遮罩本身關閉
});
$(".modal-content").on("click", e => e.stopPropagation());

優點:視覺層級清晰、無需 `document` 全域監聽、支援 ESC 鍵關閉擴展。

原生 JS 實作(無 jQuery)

const btn = document.getElementById("btn");
const modal = document.getElementById("modal");

btn.addEventListener("click", (e) => {
  e.stopPropagation();
  modal.style.display = "block";
  document.addEventListener("click", closeOnce, { once: true }); // {once:true} 等同 one()
});

modal.addEventListener("click", (e) => e.stopPropagation());

function closeOnce() {
  modal.style.display = "none";
}

總結

核心模式:**內部阻止冒泡(`stopPropagation`)+ 外部一次性監聽(`one`/`{once:true}`)**。避免全域持久監聽、邏輯耦合與重複綁定。遮罩層方案在 UI/UX 上更優,建議優先採用。

copyright © 萬盛學電腦網 all rights reserved