要素について
“form”要素は入力フォームを表す要素です。
“form”要素はフォーム関連要素を通して操作可能なハイパーリンクを表します。リンク先は“action”属性や“input”要素と“button”要素の“formaction”属性によって表されるフォームの入力値の送信先です。
ユーザーは“input”要素や“select”要素、“textarea”要素による入力欄で入力値を編集してサーバーに送信することができます。
フォーム関連要素は“form”要素の中に配置するか、“form”属性で“form”要素と関連づけることができます。
サンプルコード
属性と値
属性 | 値 | ||
---|---|---|---|
属性 | 説明 | 値 | 説明 |
必須属性 | |||
なし | |||
任意属性 | |||
グローバル属性 | |||
accept-charset="" | フォームの送信時の文字エンコーディング | utf-8 | UTF-8 |
action="" | フォームに入力されたデータの送信先 | URL | フォームに入力されたデータの送信先のURL |
autocomplete="" | ブラウザーによるオートコンプリートの可否 | on | オートコンプリートを行う |
off | オートコンプリートを行わない | ||
enctype="" | フォームが送信するデータの形式 | application/x-www-form-urlencoded | 入力されたデータをURLエンコードして送信 |
multipart/form-data | 入力されたデータをマルチパートデータとして送信 | ||
text/plain | 入力されたデータをプレーンテキストとして送信 | ||
method="" | フォームを送信時のHTTPメソッド | get | 入力されたデータを“action”属性で指定したURLにクエリ文字列として付加して送信 |
post | 入力されたデータをHTTPリクエストの本文として送信 | ||
dialog | フォームの送信時に“form”要素が含まれる“dialog”要素を閉じる | ||
name="" | フォームの名前 | 文字列 | フォームの名前 |
novalidate="" | フォームの送信時に入力内容の妥当性をチェックしない | novalidate | フォームの送信時に入力内容の妥当性をチェックしない |
target="" | フォームの送信時の応答画面の表示方法 | _blank | 新しいブラウジング・コンテキストに表示 |
_self | 現在のブラウジング・コンテキストに表示 | ||
_parent | 現在のブラウジング・コンテキストの1つ上位のブラウジング・コンテキストに表示 | ||
_top | 現在のブラウジング・コンテキストの最上位のブラウジング・コンテキストに表示 | ||
ブラウジング・コンテキスト名 | 任意のブラウジング・コンテキストに表示 | ||
rel="" | 現在の文書から見たリンク先との関係 | リンクタイプ | 現在の文書から見たリンク先との関係 |
過去に定義されていた属性
属性 | 値 | ||
---|---|---|---|
属性 | 説明 | 値 | 説明 |
accept="" | フォームが送信できるファイル形式 | MIMEタイプ | フォームが送信できるファイル形式 |
onsubmit="" | フォームを送信した時に実行されるスクリプト | スクリプト | フォームを送信した時に実行されるスクリプト |
onreset="" | フォームをリセットした時に実行されるスクリプト | スクリプト | フォームをリセットした時に実行されるスクリプト |
フォームバリデーション
“フォームバリデーション”とは?
“フォームバリデーション(Form validation)”はフォームで送信される内容の妥当性をチェックする機能です。
HTML4まではフォームの入力内容のチェックはスクリプトやフォームの送信先のプログラムでしか行うことができませんでしたが、HTML5ではブラウザの機能として利用することができるようになりました。
ユーザーによる入力内容が決められた書式を満たしているかや、入力必須の項目が入力されているかを実際にフォームの入力内容を送信先のプログラムへ送る前に確認することができます。入力内容がフォームバリデーションを通らない場合にはブラウザがフォームの送信をブロックし、エラーメッセージを表示します。
他の手段で入力内容の妥当性をチェックする場合などにフォームバリデーションを無効化したい場合は“form”要素に“novalidate”属性を指定するかフォームの送信ボタンとなる要素に“formnovalidate”属性を指定します。
入力値の書式に制約がある要素
以下の要素は入力される値の書式が正しいかが検証され、書式が不正な場合はフォームバリデーションによってフォームが送信できなくなります。
要素 | 許可される入力値 | |
---|---|---|
要素 | “type”属性の値 | |
<input> | url | 妥当な形式のURL |
妥当な形式のメールアドレス | ||
date | 機械可読な形式の日付(“YYYY-MM-DD”) | |
month | 機械可読な形式の年と月(“YYYY-MM”) | |
week | 機械可読な形式の年と週番号(“yyyy-Www”) | |
time | 機械可読な形式の時刻(“hh:mm”もしくはhh:mm:ss”) | |
datetime-local | 機械可読な形式の日時(“yyyy-MM-ddThh:mm”) | |
number | 数値 | |
range | 数値 | |
color | 7文字の16進数カラーコード(“#rrggbb”) |
入力値に制約を加える属性
以下の属性は入力値に制約を加え、その制約を満たさない場合はフォームバリデーションによってフォームが送信できなくなります。
要素 | 制約する内容 | |
---|---|---|
要素 | 属性 | |
<input> | max="" | 入力可能な値の最大値 |
maxlength="" | 入力可能な最大の文字数 | |
min="" | 入力可能な値の最小値 | |
minlength="" | 入力可能な最小の文字数 | |
pattern="" | 入力可能な入力値の書式 | |
step="" | 入力可能な数値の間隔 | |
required="" | 入力必須 | |
<select> | required="" | 入力必須 |
<textarea> | maxlength="" | 入力可能な最小の文字数 |
minlength="" | 入力可能な最大の文字数 | |
required="" | 入力必須 |
以下の属性が指定された入力欄はフォームバリデーションの対象外になります。
要素 | 説明 | |
---|---|---|
要素 | 属性 | |
<input> | disabled="" | 入力欄を無効化(値を送信しない) |
readonly="" | 入力値を編集できなくする | |
<select> | disabled="" | 入力欄を無効化(値を送信しない) |
<textarea> | disabled="" | 入力欄を無効化(値を送信しない) |
readonly="" | 入力値を編集できなくする |
仕様書
“form”要素はHTML2.0から定義されている要素です。現行の仕様であるHTML Living Standardでも定義されています。
定義されている仕様書
<form> |
---|
DOMインターフェース
[Exposed=Window]
LegacyOverrideBuiltIns,
LegacyUnenumerableNamedProperties]
interface HTMLFormElement : HTMLElement {
[HTMLConstructor] constructor();
[CEReactions] attribute DOMString acceptCharset;
[CEReactions] attribute USVString action;
[CEReactions] attribute DOMString autocomplete;
[CEReactions] attribute DOMString enctype;
[CEReactions] attribute DOMString encoding;
[CEReactions] attribute DOMString method;
[CEReactions] attribute DOMString name;
[CEReactions] attribute boolean noValidate;
[CEReactions] attribute DOMString target;
[CEReactions] attribute DOMString rel;
[SameObject, PutForwards=value] readonly attribute DOMTokenList relList;
[SameObject] readonly attribute HTMLFormControlsCollection elements;
readonly attribute unsigned long length;
getter Element (unsigned long index);
getter (RadioNodeList or Element) (DOMString name);
undefined submit();
undefined requestSubmit(optional HTMLElement? submitter = null);
[CEReactions] undefined reset();
boolean checkValidity();
boolean reportValidity();
};
UAスタイルシート
@namespace url(http://www.w3.org/1999/xhtml);
form {
display: block;
unicode-bidi: isolate;
}
:is(table,thead,tbody,tfoot,tr) > form {
display: none !important;
}
/* 文書の文字エンコーディングが ISO-8859-8 である場合 */
form {
unicode-bidi: bidi-override;
}