document.forms 是 DOM 提供的一個表單集合,讓你可以不靠 id 就取得頁面上的表單並提交。最基本的一行寫法如下:
document.forms['exportServlet'].submit();
| 寫法 | 意義 |
|---|---|
document.forms | 取得當前頁面的所有表單集合 |
document.forms[0] | 取得當前頁面的第一個表單 |
document.forms['exportServlet'] | 取得 name 為 exportServlet 的表單 |
submit() | 提交該表單 |
對應的 HTML 大概長這樣:
<form name="exportServlet" method="post" action="/export"> <input type="hidden" name="type" value="xls" /> </form>
用 form.submit() 提交時,表單上的 onsubmit 事件不會被觸發,因此表單驗證會被跳過。如果需要驗證,請改用:
document.forms['exportServlet'].dispatchEvent(
new Event('submit', { cancelable: true, bubbles: true })
);
// 或直接呼叫表單內的 submit 按鈕
document.querySelector('#submitBtn').click();
如果表單內有一個 name="submit" 的元素,那麼 form.submit 將指向該元素而不是原生方法,呼叫時會拋出錯誤。改用 HTMLFormElement.prototype.submit.call(form) 可以繞過。
document.forms[0] 依賴元素在文件中的出現順序,一旦有人調整版面就會出錯。實務上請優先使用:
document.getElementById("exportServlet"); // 建議先在 form 上設 id
document.querySelector('form[name="exportServlet"]');
document.forms 常見用途之一是不刷新頁面就觸發檔案下載:
function exportFile(url) {
var form = document.forms['exportServlet'];
form.action = url;
form.submit();
}
瀏覽器收到帶有 Content-Disposition: attachment 的回應時,會跳出下載視窗,而原頁面不會跳走。