定義と使い方
<form>タグは、データを送信するためのWebフォーム領域を表します。
この領域には「Webフォームに関連するコントロール要素」が含まれ、これらの要素のデータを送信するためのフォームを定義するために使用されます。
- Webフォームに関連するコントロール要素
- 一般的には「フォームコントロール(form controls)」と呼ばれます。フォーム要素とともに、ユーザーがWebページを操作できるようにコントロールを提供する要素(複数)を指します。
<input>、<textarea>、<select>、<button>など、ユーザーがデータを入力、選択、送信するなどの操作を行える要素が該当します。
基本例
以下の例は、<form>タグの一般的な使用方法の1つです。
<form action="submit_url" method="get" class="form-example">
<div class="form-example">
<label for="user-name">名前</label>
<input type="text" id="user-name" name="user-name" required>
</div>
<div class="form-example">
<label for="user-email">メールアドレス</label>
<input type="email" id="user-email" name="user-email" required>
</div>
<button type="submit">送信</button>
</form>
主な技術的文法の要約
<form>タグの子孫要素として、別の<form>タグを入れ子にすることはできません。
フォーム関連のコントロール要素を含む
<form>タグは、データを送信するためのフォーム関連のコントロール要素を含む領域です。テキスト入力フィールド、チェックボックス、ラジオボタン、ドロップダウンリスト、さまざまな種類のボタンなどの要素を含めることができ、これらの要素のデータを送信するためのフォームを定義するために使用されます。
参考:フォーム関連の主なコントロール要素
<input>
|
ユーザーからデータを入力してもらうための対話型コントロールを表します。 |
|---|---|
<textarea>
|
複数行のテキスト入力フィールドを表します。 |
<select>
|
設定されている選択肢の中から選択できるコントロールを表します。 |
<button>
|
内容によってラベル付けされたボタンを表します。 |
<form>タグには、このようなフォーム関連のコントロール要素だけでなく、段落、見出し、リスト、表、画像、動画など、文書の構造を形成するほとんどのコンテンツ(フローコンテンツ(flow content)を指します)も含めることができます。
関連属性の使用
<form>タグの関連属性について見ていきましょう。
action属性
フォームの送信時に、<form>で定義されたフォーム領域に含まれるコントロール要素のデータを送信するURLを指定します。
動作の説明
<form>内に送信に関連するボタン(<input type="submit">、<input type="image">、<button type="submit">)がある場合、そのボタンがクリックされると、指定されたaction属性に設定されたURLにデータが送信されます。
<form action="submit_url">
<label for="user-name">名前</label>
<input type="text" id="user-name" name="user-name">
<button type="submit">送信</button>
</form>
参考にしてください!<form>内に送信に関連するボタンがない場合は、JavaScriptを使用してsubmit()メソッドを呼び出すことで、フォーム領域を送信することもできます。この場合も、指定されたaction属性に設定されたURLにデータが送信されます。また、submitイベントハンドラーを使用して、データを任意のURLに送信することもできます。
action属性がない場合、または空文字列("")が指定されている場合
現在のURLにデータが送信されます。
参考にしてください!action属性がない場合や、空文字列("")が指定されている場合でも、フォーム領域の送信時にJavaScriptを使用して、例えばsubmitイベントハンドラーを使うことで、データを任意のURLに送信できます。
method属性
フォームの送信時に、フォーム領域のデータを送信する方法を指定します。
値
この属性の値は、フォームの送信時にフォーム領域のデータを送信するために使用するHTTPメソッドです。大文字と小文字は区別されません。
get |
method属性が指定されていない場合のデフォルト値です。データをURLのクエリ文字列として送信します。 |
|---|---|
post |
データをHTTPリクエストの本文(body)に含めて送信します。 |
dialog |
フォーム領域が<dialog>内にある場合、データを送信したりフォームをリセットしたりせずにダイアログを閉じ、送信時にsubmitイベントを発生させます。 |
<form action="submit_url" method="post">
<label for="user-name">名前</label>
<input type="text" id="user-name" name="user-name">
<button type="submit">送信</button>
</form>
novalidate属性
フォームの送信時に、フォーム領域の検証を行わないことを示します。この属性がない場合、フォーム領域の検証が行われます。この属性はブール属性(Boolean attribute)です。値を別途記述せず、属性名のみを記述します。
フォーム領域の検証には、次の2つがあります。
- HTML5の標準機能として提供されるバリデーション
required属性が指定されたコントロールに値が入力されているかどうかの検証
HTML5の標準機能として提供されるバリデーション
<input type="url">や<input type="email">を<form>タグ内で使用すると、デフォルトでブラウザによるバリデーションが行われます。
これはHTML5の標準機能で、<input type="url">では、ユーザーが正しい形式のURLを入力したかどうかを自動的に確認し、<input type="email">では、ユーザーが正しい形式のメールアドレスを入力したかどうかを自動的に確認します。
HTML5の標準機能として提供されるバリデーションを無効にするには、<form>タグ内にnovalidate属性を追加します。
次は、<form>タグ内にnovalidate属性を指定していない場合と、novalidate属性を指定した場合を比較する例です。
<h3>バリデーションを行う</h3>
<p>正しい形式のURLが入力されているかどうかを検証します。</p>
<form>
<label for="user-url">ホームページのアドレス</label>
<input type="url" id="user-url" name="user-url">
<button type="submit">送信</button>
</form>
<h3>バリデーションを行わない</h3>
<p>正しい形式のURLが入力されているかどうかを検証しません。</p>
<form novalidate>
<label for="user-url-1">ホームページのアドレス</label>
<input type="url" id="user-url-1" name="user-url-1">
<button type="submit">送信</button>
</form>
注意!URLを入力しない場合、バリデーションが行われずにフォームが送信されます。
バリデーションを行う
正しい形式のURLが入力されているかどうかを検証します。
バリデーションを行わない
正しい形式のURLが入力されているかどうかを検証しません。
required属性が指定されたコントロールに値が入力されているかどうかの検証
required属性は、フォームの送信時に、ユーザーがあらかじめ必ず値を入力または選択する必要がある必須(required)のコントロール要素であることを示します。この属性はブール属性(Boolean attribute)です。値を別途記述せず、属性名のみを記述します。
次は、<form>タグ内にnovalidate属性を指定していない場合と、novalidate属性を指定した場合を比較する例です。
<h3>required属性の検証を行う</h3>
<p>required属性が指定されているかどうかを検証します。</p>
<form>
<label for="user-name">名前</label>
<input type="text" id="user-name" name="user-name" required>
<button type="submit">送信</button>
</form>
<h3>required属性の検証を行わない</h3>
<p>required属性が指定されているかどうかの検証を行いません。</p>
<form novalidate>
<label for="user-name-1">名前</label>
<input type="text" id="user-name-1" name="user-name-1" required>
<button type="submit">送信</button>
</form>
required属性の検証が行われるかどうか、実際にテストしてみてください!
required属性の検証を行う
required属性が指定されているかどうかを検証します。
required属性の検証を行わない
required属性が指定されているかどうかの検証を行いません。
target属性
フォームの送信後に結果を表示する場所を指定します。主に、リンク先やフォームの送信先となるフレームまたはウィンドウを指定するために使用します。
値
_self |
target属性が指定されていない場合のデフォルト値です。フォームの送信結果は、現在のウィンドウまたはフレームに表示されます。 |
|---|---|
_blank |
フォームの送信結果は、新しいウィンドウまたは新しいタブに表示されます。 |
_parent |
フォームの送信結果は、親フレームに表示されます。フレーム構造がない場合は、_selfと同じように動作します。 |
_top |
フォームの送信結果は、ウィンドウ全体の最上位フレームに表示されます。フレーム構造がない場合は、_selfと同じように動作します。 |
<form action="submit_url" method="post" target="_blank">
<label for="user-name">名前</label>
<input type="text" id="user-name" name="user-name">
<button type="submit">送信</button>
</form>
enctype属性
フォーム領域に含まれるコントロール要素のデータをサーバーに送信する際に使用するエンコード形式を指定します。この属性は、method属性の値がpostに設定されているフォームで主に使用されます。enctype属性の値には、主に次の3つの選択肢があります。
値
application/x-www-form-urlencoded |
enctype属性が指定されていない場合のデフォルト値です。すべての文字がURLエンコードされて送信されます。基本的なフォームデータのエンコード方式です。 |
|---|---|
multipart/form-data |
ファイルのアップロードに対応しています。 フォームデータは複数のパートに分割して送信され、各パートは個別にエンコードされます。 <input type="file">が含まれている場合に使用します。 |
text/plain |
フォームデータはプレーンテキストとしてエンコードされます。 |
<form action="submit_url" method="post" enctype="multipart/form-data">
<label for="user-file">ファイルのアップロード</label>
<input type="file" id="user-file" name="user-file">
<button type="submit">送信</button>
</form>
name属性
name属性は、JavaScriptでフォームを参照する際に使用する名前を指定します。この名前は、文書内に複数の<form>がある場合に、JavaScriptで対象の要素を識別するために使用されます。
技術的文法の要約
ブラウザーの互換性
| タグと関連属性 |
デスクトップ Chrome
|
デスクトップ Edge
|
デスクトップ Firefox
|
Safari
|
|---|---|---|---|---|
<form>
|
1 | 12 | 1 | 4 |
action
|
1 | 12 | 1 | 3 |
novalidate
|
10 | 12 | 4 | 10.1 |
target
|
1 | 12 | 1 | 3 |
enctype
|
1 | 12 | 1 | 3 |
name
|
1 | 12 | 1 | 3 |
仕様書
| 仕様書 | |
|---|---|
<form>
|
HTML Standard #the-form-element |