DIV CSS 佈局教程網

表單按鈕命名為 submit 導致 jQuery 提交失效的陷阱與解法
編輯:JQuery特效代碼     

這個問題相當隱蔽,症狀也很容易誤判:表單怎麼送都送不出去,看程式邏輯又完全正常,最後才發現元兇竟是一個 id 的名稱。

現象

專案使用 jQuery 的 validationEngine 做非同步驗證。當使用者在表單「最後一個欄位」填完內容、直接按 Enter 送出時,表單沒有反應;必須再按一次 Enter 或點一次送出按鈕,才會真的送出。

排查過程

逐步追蹤原始碼後發現,非同步驗證成功之後,程式確實有再呼叫一次 submit,畫面上也沒有報錯,如表單就是不動。也就是說,邏輯分支是走到的,問題出在「submit 這個動作本身被攔下來了」。

真正的原因

送出按鈕的 id 被命名為 submit:

<input id="submit" type="submit" class="btn pull-left" value="登錄">

瀏覽器有一個由來已久的行為:表單內元素的 id 或 name 會被掛到 form 物件上成為屬性。於是 form.submit 不再指向原生的方法,而是指向了那顆按鈕元素本身。當程式碼呼叫 form.submit() 時,等於是在「呼叫一個 DOM 元素」,自然什麼事都不會發生,也不會丟出明顯錯誤。

解法

最直接的方式就是換掉這個 id 名稱:

<input id="submitBtn" type="submit" class="btn pull-left" value="登錄">

改名之後,form.submit 重新指向原生方法,表單就能正常送出。

如果因為種種原因無法修改既有命名,另一條路是改用原生 DOM 呼叫,明確取得方法再執行:

// 用原生元素呼叫,避開被覆寫的 form.submit
HTMLFormElement.prototype.submit.call(document.getElementById('form1'));

不過這寫法可讀性差,還是建議改名。

哪些名稱要避開

凡是會與 form 原生屬性或方法同名的,都建議別用在表單內部的元素 id/name 上,例如:

submit、reset、action、method、target、elements、length、id、onsubmit。

特別是 submit 與 reset 這兩個最容易誤中,因為它們剛好也是按鈕最直覺的命名。

延伸提醒

同一個坑也會出現在全域命名上。若在頁面中宣告 var name = ... 或 var status = ...,在部分瀏覽器裡可能與 window.name 等內建屬性相撞,造成難以追蹤的錯誤。養成「id 加上語意化前綴」的習慣(例如 loginSubmitBtn 而非 submit),能省下不少排查時間。

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