這是一個非常經典、也非常容易讓人抓不到的坑:頁面上的分頁、跳轉、組合查詢等依賴 form.submit() 的功能集體失靈,控制台拋出 submit is not a function,而所有代碼看起來都毫無問題。
<form id="pquery" method="post" action="supplierAction!list.action">
<div class="menu">
商品名稱:
<input name="bill.goodsname" class="input-text" type="text">
是否付款:
<select name="bill.pay">
<option value="">請選擇</option>
<option value="01">已付款</option>
<option value="02">未付款</option>
</select>
<!--就是因為下面這個按鈕的名稱叫做 submit 導致 js 失效-->
<input name="submit" value="組合查詢" class="button" type="submit">
</div>
<div style="text-align: center;">
每頁顯示
<select name="page.pageItems" onchange="gotoSelectedPage1()">
<option value="5">5</option>
<option value="10" selected="selected">10</option>
<option value="20">20</option>
<option value="50">50</option>
</select> 條 共6條記錄 第
<input id="curpage" name="page.currentPage" readonly="readonly" value="1" size="3">
頁 / 共1頁
<a href="javascript:page_first();">第一頁</a>
<a href="javascript:page_last();">最後一頁</a>
跳轉頁碼至:
<select style="width: 40px;" id="selectpage" onchange="gotoSelectedPage()">
<option value="1" selected="selected">1</option>
</select>
</div>
<script type="text/javascript">
function sel(val){ return document.getElementById(val); }
var page = sel('curpage');
var form = sel('pquery');
var select = sel('selectpage');
function page_first() { page.value = 1; form.submit(); }
function page_pre() { var a = parseInt(page.value) - 1; page.value = a; page_validate(); form.submit(); }
function page_next() { var a = parseInt(page.value) + 1; page.value = a; page_validate(); form.submit(); }
function page_last() { page.value = 1; form.submit(); }
function page_validate() {
var a = page.value;
if (a < 1) { a = 1; }
if (a > 1) { a = 1; }
page.value = a;
}
function gotoSelectedPage1() { page.value = 1; form.submit(); }
function gotoSelectedPage() { page.value = select.value; form.submit(); }
</script>
</form>
問題出在這一行的命名上:
<input name="submit" value="組合查詢" type="submit">
瀏覽器有一個約定俗成的行為:表單內部的元素可以透過 name 直接作為表單的屬性來訪問。也就是說,form.name、form.id、form.action 這類寫法都能取到對應的表單控件。
當你給某個控件命名為 submit 之後,form.submit 取到的就不再是那個原生方法,而是這個 input 元素本身。於是 form.submit() 相當於「把一個 DOM 元素當函數調用」,自然會報 is not a function。
把 name 屬性刪掉或者改個名字,一切立刻恢復正常。
· 不要讓控件的 name/id 與表單的屬性或方法同名。高頻雷區包括:submit、action、method、target、reset、elements、length、id、style。
· 提交時改用更明確的寫法。例如 HTMLFormElement.prototype.submit.call(form),可以繞開被同名控件遮蔽的問題。
· 或者乾脆讓交互按鈕走 type="button",由 JS 統一控制提交時機,避免依賴隱喻式的表單行為。
· 遇到「某個 DOM 方法突然不存在」的狀況,第一時間就該去檢查是否有同名元素把它遮住了——這條經驗能省下大量排查時間。