Document.forms

ジャンプ先:
  1. 構文
  2. 例
  3. 仕様書
  4. ブラウザーの対応
  5. 関連情報

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 の定義		 廃止された 初回定義

ブラウザーの対応

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeEdge MobileAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
基本対応Chrome 完全対応 ありEdge ? Firefox 完全対応 ありIE ? Opera ? Safari ? WebView Android 完全対応 ありChrome Android 完全対応 ありEdge Mobile ? Firefox Android 完全対応 ありOpera Android ? Safari iOS ? Samsung Internet Android ?

凡例

完全対応  
完全対応
実装状況不明  
実装状況不明

関連情報

ドキュメントのタグと貢献者

タグ: 
このページの貢献者: mfuji09, fscholz, khalid32, ethertank, Okome
最終更新者: mfuji09,