DOM
：インターフェイス
：HTMLFormElement インターフェイス
編集：2022.03.08 by T.A.
→MS、MS（en）
DOM 内で <form> 要素を表します。これは、フォームのコンポーネント要素へのアクセスだけでなく、フォームの様々な側面へのアクセスや、場合によっては変更を可能にします。
プロパティ
このインターフェイスは親である HTMLElement からプロパティを継承しています。
- HTMLFormElement.elements 読取専用
- HTMLFormControlsCollection。このフォーム要素に所属するすべてのフォーム コントロールを保持します。
- HTMLFormElement.length 読取専用
- long。フォーム内のコントロールの数を反映します。
- HTMLFormElement.name
- DOMString。フォームの name 属性の値を反映し、フォームの名前を表します。
- HTMLFormElement.method
- DOMString。フォームの method 属性の値を反映し、フォームを送信するために使用する HTTP メソッドを示します。指定された値のみが設定できます。
- HTMLFormElement.target
- DOMString。フォームの target 属性の値を反映し、フォームを送信して受け取った結果を表示する場所を示します。
- HTMLFormElement.action
- DOMString。フォームの action 属性の値を反映し、フォームによって送信された情報を処理するプログラムの URI を示します。
- HTMLFormElement.encoding
または HTMLFormElement.enctype
- DOMString。フォームの enctype 属性の値を反映し、フォームをサーバーへ送信するのに使用するコンテンツの型を示します。指定された方のみが設定できます。二つのプロパティは別名です。
- HTMLFormElement.acceptCharset
- DOMString。フォームの accept-charset 属性の値を反映し、サーバーが受け付ける文字エンコーディングを表します。
- HTMLFormElement.autocomplete
- DOMString。フォームの autocomplete 属性の値を反映し、ブラウザーが自動的にこのフォーム内のコントロールの値を生み出すことができるかどうかを示します。
- HTMLFormElement.noValidate
- Boolean。フォームの novalidate 属性の値を反映し、フォームの検証を行わないかどうかを示します。
名前の付いた入力欄がプロパティとしてオーナーのフォームのインスタンスに追加され、同じ名前のネイティブのプロパティがあると上書きしてしまいます（例えば、フォームに action という名前の入力欄がある場合、action プロパティはフォームの action 属性ではなくその入力欄を返します）。
メソッド
このインターフェイスは親である HTMLElement からメソッドを継承しています。
- HTMLFormElement.checkValidity()
- この要素の子コントロールが制約検証の対象となり、それらの制約を満たしている場合は true を返します。制約を満たさないコントロールがある場合は false を返します。制約を満たさないコントロールに対して、invalid という名前のイベントを発生させます。イベントがキャンセルされない場合、そのようなコントロールは無効とみなされます。false にどう対応するかはプログラマー次第です。
- HTMLFormElement.reportValidity()
- 要素の子コントロールがその検証する制約を満たしている場合、true を返します。false が返された場合、無効な子要素それぞれにキャンセル可能な invalid イベントが発生し、検証上の問題がユーザーに報告されます。
- HTMLFormElement.requestSubmit()
- 指定された送信ボタンとそれに対応する設定を使用してフォームを送信するよう要求します。
- HTMLFormElement.reset()
- フォームを初期状態にリセットします。
- HTMLFormElement.submit()
- フォームをサーバーへ送信します。
非推奨のメソッド
- HTMLFormElement.requestAutocomplete() 廃止 非推奨
- ネイティブのブラウザーインターフェイスを起動して、自動補完フィールド名 の値が off または on ではないフィールドを補完してユーザーを支援します。ユーザーがインターフェイスの操作を終えると、フォームはフィールドが入力された場合は autocomplete、問題があった場合は autocompleteerror のいずれかのイベントを受け取ります。
イベント
これらのイベントを待ち受けするには、addEventListener() を使用するか、このインターフェイスの oneventname プロパティへイベントリスナーを代入するかしてください。
- formdata
- formdata イベントは、フォームのデータを表す項目リストが構築されると発行されます。
onformdata プロパティからも利用できます。
- reset
- reset イベントはフォームがリセットされたときに発行されます。
onreset プロパティからも利用できます。
- submit
- submit イベントはフォームが送信されたときに発行されます。
onsubmit プロパティからも利用できます。
¶省く
¶例省く
テスト
ここに表示