DIV CSS 佈局教程網

表單照樣送出?監聽函式 return false 失效的真正原因
編輯:關於JavaScript     

用 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>

關鍵:preventDefault()

正確做法是在事件處理函式中呼叫 event.preventDefault(),明確告訴瀏覽器「取消這個元素的預設行為」。舊版 IE 不支援這個方法,要用 window.event.returnValue = false 取代,因此兩者並存才是完整的相容寫法。

這裡還有兩個細節值得注意:其一,事件物件必須從參數接收,而不是從全域抓,這樣在 Firefox 等瀏覽器上才拿得到;其二,把綁定動作放進 window.onload,確保 DOM 已經就緒,否則在 head 中執行會找不到元素。

補充:preventDefault 與 stopPropagation 不同

初學者常把兩者搞混,但它們的作用完全不同:

  • 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 屬性能省下不少驗證程式碼。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved