Document インターフェイスの forms プロパティは読み取り専用で、文書内に含まれるすべての <form> を列挙した HTMLCollection を返します。
メモ: 同様に、 HTMLFormElement.elements プロパティを使用すると、フォームコンポーネントのユーザー入力要素のリストにアクセスすることができます。
構文
collection = document.forms;
値
文書のすべてのフォームを列挙する HTMLCollection オブジェクトです。コレクションのそれぞれの項目は、単一の <form> 要素を表す HTMLFormElement です。
文書にフォームがない場合、返されるコレクションは空で、長さはゼロです。
例
フォーム情報の取得
<!DOCTYPE html> <html lang="en"> <head> <title>document.forms example</title> </head> <body> <form id="robby"> <input type="button" onclick="alert(document.forms[0].id);" value="robby's form" /> </form> <form id="dave"> <input type="button" onclick="alert(document.forms[1].id);" value="dave's form" /> </form> <form id="paul"> <input type="button" onclick="alert(document.forms[2].id);" value="paul's form" /> </form> </body> </html>
フォーム内要素の取得
var selectForm = document.forms[index]; var selectFormElement = document.forms[index].elements[index];
名前付きフォームへのアクセス
<!DOCTYPE html> <html lang="en"> <head> <title>document.forms example</title> </head> <body> <form name="login"> <input name="email" type="email"> <input name="password" type="password"> <button type="submit">Log in</button> </form> <script> var loginForm = document.forms.login; // Or document.forms['login'] loginForm.elements.email.placeholder = 'test@example.com'; loginForm.elements.password.placeholder = 'password'; </script> </body> </html>
仕様書
| 仕様書 | 状態 | コメント |
|---|---|---|
| HTML Living Standard Document.forms の定義 |
現行の標準 | |
| Document Object Model (DOM) Level 2 HTML Specification Document.forms の定義 |
廃止された | 初回定義 |
ブラウザーの対応
このページの互換性一覧表は構造化データから生成されています。データに協力したいのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。
Update compatibility data on GitHub
| デスクトップ | モバイル | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
forms | Chrome 完全対応 1 | Edge 完全対応 12 | Firefox 完全対応 あり | IE ? | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android ? |
凡例
- 完全対応
- 完全対応
- 実装状況不明
- 実装状況不明
関連情報
- DOM:form
<form>およびHTMLFormElementインターフェイス