萬盛學電腦網

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

jQuery 事件防預設行為:preventDefault() 實戰應用

核心用途

`event.preventDefault()` 取消瀏覽器對事件的**預設行為**:表單提交、連結跳轉、右鍵選單、輸入法組合等。不阻止事件冒泡 (需用 `stopPropagation()`)。

經典場景:表單驗證攔截提交

<!DOCTYPE html>
<html>
<head>
  <title>preventDefault 範例:搜尋表單驗證</title>
  <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
  <script>
    $(function() {
      $("#myform").submit(function(e) {
        if ($("#search").val().trim() === "") {
          alert("搜尋內容不能為空");
          e.preventDefault(); // 取消表單提交
        }
      });
    });
  </script>
</head>
<body>
  <form action="https://www.google.com/search" method="get" id="myform">
    <input type="text" name="q" id="search" size="38" placeholder="輸入關鍵字..." />
    <input type="submit" value="搜尋" />
  </form>
</body>
</html>

事件對象 `e` 取得方式

// 1. 匿名函式參數 (推薦)
$("#form").submit(function(e) { e.preventDefault(); });

// 2. 箭頭函式 (需用 event.currentTarget)
$("#form").submit((e) => { e.preventDefault(); });

// 3. 內聯事件 (不推薦)
<form onsubmit="return handleSubmit(event)">
function handleSubmit(e) { if (!valid) { e.preventDefault(); return false; } }

常見預設行為對照表

元素/事件預設行為preventDefault() 效果
<a> click跳轉 href阻止跳轉
<form> submit送出表單阻止送出
<input> keydown輸入字元阻止字元輸入 (可做輸入過濾)
contextmenu顯示右鍵選單阻止右鍵選單
dragstart開始拖曳禁止拖曳
wheel (passive: false)頁面捲動阻止捲動 (需 passive:false)
touchmove觸控捲動阻止捲動 (需 passive:false)

preventDefault vs stopPropagation vs return false

寫法阻止預設行為阻止冒泡停止當前函式後續代碼
e.preventDefault()✅❌❌
e.stopPropagation()❌✅❌
e.stopImmediatePropagation()❌✅ (含同元素其他 handler)❌
return false (jQuery handler)✅✅✅
return false (原生 onxxx)✅❌✅

實戰進階:自訂右鍵選單

<style>
#customMenu { position: fixed; display: none; background: white; border: 1px solid #ccc; box-shadow: 0 2px 8px rgba(0,0,0,0.15); padding: 5px 0; z-index: 9999; min-width: 150px; }
#customMenu div { padding: 8px 15px; cursor: pointer; white-space: nowrap; }
#customMenu div:hover { background: #f0f0f0; }
</style>

<div id="customMenu">
  <div data-action="copy">複製</div>
  <div data-action="paste">貼上</div>
  <hr style="margin:5px 0;border:none;border-top:1px solid #eee">
  <div data-action="inspect">檢查元素</div>
</div>

<script>
$(document).on("contextmenu", function(e) {
  e.preventDefault(); // 關鍵:阻止原生右鍵選單
  $("#customMenu").css({ left: e.pageX, top: e.pageY }).show();
}).on("click", function() {
  $("#customMenu").hide();
});

$("#customMenu").on("click", "div", function() {
  var action = $(this).data("action");
  console.log("自訂選單動作:", action);
  $(this).parent().hide();
});
</script>

現代補充:passive event listeners

為提升捲動效能,現代瀏覽器預設 `touchstart`/`wheel` 為 `passive: true` (不阻塞主執行緒)。若需在這些事件中呼叫 `preventDefault()`,必須顯式註冊:

element.addEventListener('touchmove', function(e) {
  if (shouldPrevent) e.preventDefault();
}, { passive: false }); // 關鍵:聲明非被動

總結

  • `preventDefault()` 是表單驗證、自訂右鍵、拖曳控制、單頁應用路由攔截的核心工具。
  • 區分「預設行為」與「事件冒泡」兩個獨立機制,按需呼叫對應方法。
  • jQuery 事件處理函式中 `return false` = `preventDefault() + stopPropagation()`,使用時需明確語意。
copyright © 萬盛學電腦網 all rights reserved