這是一個非常經典的「莫名其妙就壞了」的 bug:分頁功能怎麼點都沒反應,把按鈕的 name 屬性刪掉卻立刻正常。原因不在你的邏輯,而在名字撞車。
<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>
<!-- 就是這個 name="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> 條
<input id="curpage" name="page.currentPage" value="1" readonly="readonly">
頁 / 共 1 頁
<a href="javascript:page_first();">第一頁</a>
<a href="javascript:page_last();">最後一頁</a>
</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_last() { page.value = 1; form.submit(); }
function gotoSelectedPage1() { page.value = 1; form.submit(); }
function gotoSelectedPage() { page.value = select.value; form.submit(); }
</script>
</form>
瀏覽器有個歷史包袱:表單內具名(有 name 或 id)的元素,會自動掛成該 form 物件的屬性。也就是說:
document.forms.pquery["bill.goodsname"] // 那個 input 元素 document.forms.pquery["submit"] // 那個 submit 按鈕
而 form.submit 本身是 HTMLFormElement 的原生方法。當你把按鈕命名為 submit,這個名字就遮蔽(shadow)了原型上的方法。於是 form.submit() 實際上是去呼叫那個 input 元素,瀏覽器便丟出:
form.submit is not a function
因為 page_first、page_last、gotoSelectedPage 全都用到 form.submit(),所以整組分頁功能一起掛掉。把 name 刪掉,遮蔽消失,一切恢復正常。
避開與 form 原生成員同名的字眼,例如改成 name="searchBtn"。需要留意的地雷名還包括 action、method、reset、target、elements、length、id、onsubmit 等。
// 用 HTMLFormElement.prototype 上的方法,繞過被遮蔽的屬性 HTMLFormElement.prototype.submit.call(form);
// type="submit" 的按鈕點擊本來就會送出表單,
// 需要額外帶值時改用 click()
document.querySelector('.button').click();
這個坑不只發生在 submit 上。任何「元素 name 與 DOM 物件既有屬性同名」的情況都可能出事,例如把 input 命名為 title 或 children。命名時養成加前綴或後綴的習慣(如 btnSubmit、fieldName),就能大幅避開這類問題。另外,用 document.getElementById 或 querySelector 取元素、用 form.requestSubmit()(新版 API)送出表單,也比依賴 form.submit 更不容易踩到遮蔽。