用 addEventListener 綁定 submit 事件,在處理函式裡 return false,表單卻還是送出——這是許多人踩過的坑。原因很簡單:return false 是舊式行內事件(onsubmit="return false")的語法,在 addEventListener 中完全無效。
<form action="https://www.jb51.net" id="form">
<input type="text" />
<input type="submit" />
</form>
<script>
var code = function () {
return false;
};
var element = window.document.getElementById("form");
if (element.addEventListener) {
element.addEventListener("submit", code, false);
}
</script>
回傳值會被 addEventListener 直接丟棄,所以表單依然會送出。
<form action="https://www.jb51.net" id="form">
<input type="text" />
<input type="submit" id="btnSubmit" name="btnSubmit" value="Submit" />
</form>
<script>
var code = function (eventObject) {
if (eventObject.preventDefault) {
eventObject.preventDefault();
} else if (window.event) { /* for ie */
window.event.returnValue = false;
}
return true;
};
window.onload = function() {
var element = window.document.getElementById("form");
if (element.addEventListener) {
element.addEventListener("submit", code, false);
} else if (element.attachEvent) {
element.attachEvent("onsubmit", code);
}
};
</script>
正確做法是在事件處理函式中呼叫 event.preventDefault(),明確告訴瀏覽器「取消這個元素的預設行為」。舊版 IE 不支援這個方法,要用 window.event.returnValue = false 取代,因此兩者並存才是完整的相容寫法。
這裡還有兩個細節值得注意:其一,事件物件必須從參數接收,而不是從全域抓,這樣在 Firefox 等瀏覽器上才拿得到;其二,把綁定動作放進 window.onload,確保 DOM 已經就緒,否則在 head 中執行會找不到元素。
初學者常把兩者搞混,但它們的作用完全不同:
preventDefault():取消元素的預設行為,如表單送出、連結跳轉。stopPropagation():停止事件繼續冒泡到父元素,但不影響預設行為。本例要阻止的是「表單送出」這個預設行為,所以必須用 preventDefault();單純 stopPropagation() 是擋不住的。
1. preventDefault 函式的使用請參考:https://developer.mozilla.org/en/DOM/event.preventDefault
2. DOM Events 規範:https://www.w3.org/TR/DOM-Level-2-Events/events.html#Events-Event-preventDefault
今日寫法更簡單:直接用 element.addEventListener('submit', e => e.preventDefault()),不必再管 IE 分支。另外若表單有必填欄位,別忘了 HTML5 的 required 屬性能省下不少驗證程式碼。