HTMLInputElement インターフェイス
HTMLInputElement インターフェイスは、単一のデータ入力を受け付ける<form> の部品である <input> エレメントを定義したインターフェイスです。
HTMLInputElement インターフェイスは、 <input> エレメントのプロパティ、メソッド、イベントを定義しています。
- EventTarget
-
- └ Node
-
- └ Element
-
- └ HTMLElement
-
- ┆
- ├ HTMLInputElement
- ┆
ページ内 Index
INPUT エレメントの内容を送信したくない場合は、disabled属性を true にします。
プロパティ(Properties)
HTMLInputElement インターフェイスは 以下の独自のプロパティをもちます。HTMLElement インターフェイス のプロパティも継承しています。
| プロパティ | 概要 | 分類 |
|---|---|---|
| .form | 親エレメント <form> へのハンドラー | |
| .formAction | フォームデータの送信先の設定と取得。 <form> の action 属性の値は上書きされる。type属性が 'submit' と 'img' である場合に有効。USVString 型 | |
| .formEnctype | フォームデータの MIME 型宣言の設定と取得。 <form> の enctype 属性の値は上書きされる。DOMString 型 | |
| .formMethod | フォームデータの HTTP メソッドの設定と取得。 <form> の method 属性の値は上書きされる。DOMString 型 | |
| .formEnctype | 送信データの形式 enctype 属性のこと。 <form> の enctype 属性よりも優先される。 DOMString 型 | |
| .formMethod | HTTP メソッド 'GET'、'POST' の設定。 <form> の method 属性よりも優先される。DOMString 型 | |
| .formNoValidate | データ送信時に値のチェックを行わないという設定。 <form> の novalidate 属性よりも優先される。Boolean 型 | |
| .formTarget | 返信されたレスポンスを表示する Window または iframe の指定。 <form> の target 属性よりも優先されるDOMString 型。 | |
| .labels | 関連付けられた <label> を NodeList で返す | |
| .menu | 関連付けられた <menu> を返す。 <menu> は <li> と併用したリスト表示のために使う | |
| .tabIndex | タブによるショートカットキーのフォーカス順を指定。long 型 | |
| .type |
以下の機能を指定。DOMString 型
| |
| .willValidate | readonly または disabled ではないかを取得。データを送信する対象なら true を返す。 Boolean 型 | |
| .validationMessage | エラーメッセージを取得。エラーがなければ null 。DOMString 型 | |
| .validity | ボタンの有効性を示す ValidityState オブジェクトを返す | |
| .value | 送信される値を取得と設定。DOMString 型 |
以下は、HTMLElement インターフェイスのプロパティと継承したプロパティです。参考にしてください。
Nodeのプロパティ一覧
| タイプ名（ハンドラー名） | 概要 | 分類 |
|---|
Elementのプロパティ一覧
| タイプ名（ハンドラー名） | 概要 | 分類 |
|---|
HTMLElementのプロパティ一覧
| タイプ名（ハンドラー名） | 概要 | 分類 |
|---|
メソッド(Methods)
HTMLInputElement インターフェイスは 以下の独自のメソッドがあります。さらに継承したメソッドがあります。
| メソッド | 概要 | 分類 |
|---|---|---|
| .checkValidity() | データの検証を実行。エラーがある場合は invalid イベントが発生。検証範囲の設定が必要。type="reset"、"button" は非対応。 Boolean 型 | |
| .reportValidity() | データの検証を実行。エラーがある場合は invalid イベントが発生しメッセージを出力。検証範囲の設定が必要。type="reset"、"button" は非対応。 Boolean 型 | |
| .setCustomValidity() | データの検証エラーを任意に発生できる。引数が指定されるとエラー状態になる。引数を空文字 '' にすると終了。type="reset"、"button" は非対応。 void 型 |
HTMLInputElement インターフェイスが継承したHTMLElement インターフェイスのメソッドです。 Node 、Element インターフェイスのメソッドを含みます。使えないものもあるので参考してください。
Nodeのメソッド一覧
| タイプ名（ハンドラー名） | 概要 | 分類 |
|---|
Elementのメソッド一覧
| タイプ名（ハンドラー名） | 概要 | 分類 |
|---|
HTMLElementのメソッド一覧
| タイプ名（ハンドラー名） | 概要 | 分類 |
|---|
イベント(Event)
HTMLInputElement にイベントハンドラーを定義する方法には以下があります。
HTMLInputElement.addEventListener( 'click', ()=>{...} )
HTMLInputElement.onclick = function(){...}
<button onclick = "..." >
イベントについてはEventを参照してください。 イベントの監視についてはEventTargetが担っています。
以下は、HTMLInputElement が継承しているイベント一覧です。使えないものもあるので参考にしてください。
GlobalEventHandlersのイベント一覧
| タイプ名（ハンドラー名） | 概要 | 分類 |
|---|
DocumentAndElementEventHandlersのイベント一覧
| タイプ名（ハンドラー名） | 概要 | 分類 |
|---|
HTMLElementのイベント一覧
| タイプ名（ハンドラー名） | 概要 | 分類 |
|---|