DIV CSS 佈局教程網

document.forms 的用法:如何取得與提交表單
編輯:JavaScript綜合知識     

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>

三個實務上的重點

1. submit() 不會觸發 onsubmit

用 form.submit() 提交時,表單上的 onsubmit 事件不會被觸發,因此表單驗證會被跳過。如果需要驗證,請改用:

document.forms['exportServlet'].dispatchEvent(
  new Event('submit', { cancelable: true, bubbles: true })
);
// 或直接呼叫表單內的 submit 按鈕
document.querySelector('#submitBtn').click();

2. 有同名元素時 submit 會被覆蓋

如果表單內有一個 name="submit" 的元素,那麼 form.submit 將指向該元素而不是原生方法,呼叫時會拋出錯誤。改用 HTMLFormElement.prototype.submit.call(form) 可以繞過。

3. 索引順序不可靠

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 的回應時,會跳出下載視窗,而原頁面不會跳走。

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