做表單驗證時,我們往往需要在資料真正送出去之前先攔一道。jQuery 裡的 preventDefault() 正是負責這件事的核心方法。本文透過一個搜尋表單的實作,帶你理解它的用法,以及背後牽涉到的事件模型觀念。
頁面上有一個搜尋欄位,送出後要導向搜尋引擎。但若使用者什麼都沒填就按下送出,我們希望先跳出提示訊息,同時不要真的跳頁。這就需要在 submit 事件裡判斷,並取消瀏覽器的預設導行動作。
<html>
<head>
<title>jquery 事件:preventDefault() 方法的使用</title>
<script type="text/javascript" src="jquery-1.8.2.min.js"></script>
<script type="text/javascript">
$(function(){
$("#myform").submit(function(e){
if($("#search").val()==""){
alert("搜尋內容不能為空");
e.preventDefault();
}
});
});
</script>
</head>
<body>
<form action="https://www.baidu.com" method="post" id="myform">
<input type="text" size="38" id="search" /><input type="submit" value="搜尋" />
</form>
</body>
</html>
只要幫匿名函式加上一個參數,就能取得事件的相關資訊。範例中的 e 代表事件物件本身,命名慣例上用 e 或 event 都可以。
呼叫事件物件的 preventDefault() 方法,可以阻止該事件的預設行為發生——在本例中,就是阻止表單真的把資料送到 https://www.baidu.com。
這兩個方法經常被混用,其實分工很清楚:preventDefault() 攔的是「預設行為」,而 stopPropagation() 攔的是「事件冒泡」。要阻止表單送出用前者,要阻止事件往父元素傳遞則用後者。關於事件捕捉與冒泡模型的細節,可參考事件傳遞相關的專文。
在 jQuery 的事件處理函式中直接 return false;,效果等同於同時執行 preventDefault() 與 stopPropagation()。程式碼更短,但語意較不明確,團隊開發時建議還是寫清楚比較好維護。