DOM

HTMLInputElement インターフェイス

 編集:2022.11.08 by T.A.

[Edge]。→

<input> 要素のオプション、レイアウト、表示方法を操作するための特別なプロパティやメソッドを提供します。

EventTargetNodeElementHTMLElement ← HTMLInputElement

プロパティ
親フォームに関連するプロパティ
HTMLInputElement.form 読取専用
HTMLInputElement に割り当てられている <form> 要素への参照を返します。
HTMLInputElement.formAction
HTMLInputElement のフォーム送信をするときの処理プログラムの URI を表す文字列を取得/設定します。

HTMLの formaction 属性を反映しています。

HTMLInputElement.formEnctype
HTMLInputElement のフォームをサーバーに送信する際の内容の型を文字列で取得/設定します。

HTMLの formenctype 属性を反映しています。

HTMLInputElement.formMethod
HTMLInputElementフォームを送信する際に用いる HTTP メソッドを表す文字列で取得/設定します。

HTMLの formmethod 属性を反映しています。

HTMLInputElement.formNoValidate
HTMLInputElement で送信時にそのフォームが検証されないかどうかを論理値で取得/設定します。

HTMLの formnovalidate 属性を反映しています。

HTMLInputElement.formTarget
HTMLInputElementフォームを送信した後で受け取った応答を表示する場所を示す名前またはキーワードを文字列で取得/設定します。

HTMLの formtarget 属性を反映しています。

type=hidden 以外のあらゆる型の input 要素に適用されるプロパティ
HTMLInputElement.name
フォーム送信時に HTMLInputElement を識別する名前を文字列で取得/設定します。

HTMLの name 属性を反映しています。

HTMLInputElement.type
HTMLInputElement を制御する型を示す文字列で取得/設定します。

HTMLの type 属性を反映しています。

HTMLInputElement.disabled
HTMLInputElement の入力を無効にするかどうかを論理値で取得/設定します。

HTMLの disabled 属性を反映しています。

HTMLInputElement.autofocus
HTMLInputElement を自動的にフォーカスさせるかどうかを論理値で取得/設定します。

HTMLの autofocus 属性を反映しています。

HTMLInputElement.required
HTMLInputElement で入力が必須であるかどうかを論理値で取得/設定します。

HTMLの required 属性を反映しています。

HTMLInputElement.value
HTMLInputElement の値を文字列で取得/設定します。

HTMLの value 属性を反映しています。

HTMLInputElement.validity 読取専用
HTMLInputElement の現在の検証状態を表す ValidityState オブジェクトを返します。
HTMLInputElement.validationMessage 読取専用
HTMLInputElement の制約検証結果で満たさなかった場合、それを記述したメッセージを文字列で返します。
HTMLInputElement.willValidate 読取専用
HTMLInputElement が制約検証の候補であるかどうかを論理値で返します。
type=checkbox または radio、の要素にのみに適用できるプロパティ
HTMLInputElement.checked
HTMLInputElementtype が checkbox または radio の場合、要素の現在の状態を論理値で取得/設定します。
HTMLInputElement.defaultChecked
HTMLInputElementtype が checkbox または radio の場合、初期表示でのチェック状態をどうすかを論理値で取得/設定します。
HTMLInputElement.indeterminate
HTMLInputElementtype が checkbox または radio の場合、ボタンの状態が不確定であるかどうかを論理値で示します。
type=image の要素のみに適用できるプロパティ
HTMLInputElement.alt
HTMLInputElementtype が image の場合、画像が表示されない場合の代替テキストを文字列で取得/設定します。

HTMLの alt 属性を反映しています。

HTMLInputElement.height
HTMLInputElementtype が image の場合、表示画像の高さのピクセル数を表す数値を取得/設定します。

HTMLの height 属性を反映しています。

HTMLInputElement.src
HTMLInputElementtype が image の場合、画像のリソースを示す URI を文字列で取得/設定します。

HTMLの src 属性を反映しています。

HTMLInputElement.width
HTMLInputElementtype が image の場合、表示画像の横幅のピクセル数を表す数値を取得/設定します。

HTMLの width 属性を反映しています。

type=file の要素のみに適用できるプロパティ
HTMLInputElement.accept
HTMLInputElementtype が file の場合、受け入れるファイルの拡張子をカンマ区切りのリストを表す文字列で取得/設定します。

HTMLの accept 属性を反映しています。

HTMLInputElement.allowdirs 非標準 [Edge]⛌
HTMLInputElementtype が file の場合、表示されるファイル リストでディレクトリーとファイルの両方を選択できるようにするかどうかを論理値で示します。¶設定できるか不明。
HTMLInputElement.files
HTMLInputElementtype が file の場合、指定したファイルのリストを FileList で返します。
HTMLInputElement.webkitdirectory 非標準
HTMLInputElementtype が file の場合、ファイル取得時にディレクトリーのみを選択するかどうかを論理値で取得/設定します。

HTMLの webkitdirectory 属性を反映しています。

HTMLInputElement.webkitEntries 非標準
HTMLInputElementtype が file の場合、webkitdirectory プロパティが true である場合に、そのディレクトリー内容を取得します。
type=他。プロパティ
HTMLInputElement.autocomplete
HTMLInputElement の制御値をブラウザーで自動的に補完できるかどうかを文字列で取得/設定します。

type=text、search、tel、url、email のときに有効です。¶

HTMLの autocomplete 属性を反映しています。

HTMLInputElement.max
HTMLInputElement の value の最大値を表す数値または日時を文字列で取得/設定します。minより小さくすることはできません。

type=date、month、week、time、datetime-local、number、range のときに有効です。¶

HTMLの max 属性を反映しています。

HTMLInputElement.maxLength
HTMLInputElement の入力できる最大文字数を数値で取得/設定します。

type=text、search、tel、url、email、password のときに有効です。¶

HTMLの maxlength 属性を反映しています。

HTMLInputElement.min
HTMLInputElement の value の最小値を表す数値または日時を文字列で取得/設定します。maxより大きくすることはできません。

type=date、month、week、time、datetime-local、number、range のときに有効です。¶

HTMLの min 属性を反映しています。

HTMLInputElement.minLength
HTMLInputElement の入力できる最小文字数を数値で取得/設定します。

type=text、search、tel、url、email、password のときに有効です。¶

HTMLの minlength 属性を反映しています。

HTMLInputElement.pattern
HTMLInputElement の制御値をチェックするための正規表現を表す文字列で取得/設定します。

type 属性の値が text、search、tel、url、email の場合に適用されます。

HTMLの pattern 属性を反映しています。

HTMLInputElement.placeholder
HTMLInputElement の初期入力に表示する内容を文字列で取得/設定します。

type 属性の値が text、search、tel、url、email の場合に適用されます。

HTMLの placeholder 属性を反映しています。

HTMLInputElement.readOnly
HTMLInputElement でユーザーが値をを変更できないかどうかを論理値で取得/設定します。

type 属性の値が hidden、range、color、checkbox、radio、file には適用されません。

HTMLの readonly 属性を反映しています。

HTMLInputElement.selectionStart
HTMLInputElement でのテキスト入力カーソル(キャレット)の位置を数値で取得/設定します。

範囲選択の場合は、選択前方の位置を示します。

HTMLInputElement.selectionEnd
HTMLInputElement でのテキスト入力カーソル(キャレット)の位置を数値で取得/設定します。

範囲選択の場合は、選択後方の位置を示します。

HTMLInputElement.selectionDirection
HTMLInputElement で選択が行われた方向を文字列で取得/設定します。
HTMLInputElement.size
HTMLInputElement の外見のサイズ(emサイズ?)を数値で取得/設定します。

type が text、search、tel、url、email、password の場合のみ適用されます。

HTMLの size 属性を反映しています。

HTMLInputElement.step
HTMLInputElement の value 値の増減値を文字列で取得/設定します。

HTMLの step 属性を反映しています。

未分類のプロパティ
HTMLInputElement.defaultValue
HTMLInputElement の初期値を文字列で取得/設定します。特にフォームでリセットをしたときに効力があります。
HTMLInputElement.dirName [Edge]?
HTMLInputElement の書字方向を表す文字列を取得/設定します。
HTMLInputElement.accessKey
押されると HTMLInputElement への制御に移るためのキー文字を文字列で取得/設定します。

¶HTMLの accesskey 属性を反映しています。

HTMLInputElement.list 読取専用
HTMLInputElement のオート コンプリート オプションのリストを表すオブジェクトを返します。

HTMLの list 属性を反映しています。

HTMLInputElement.multiple
HTMLInputElement の入力フィールドが複数の値を持つことができるかを論理値で取得/設定します。

HTMLの multiple 属性を反映しています。

HTMLInputElement.labels 読取専用
HTMLInputElement に関連付けられた LABEL要素のリストを NodeList で返します。
HTMLInputElement.step
HTMLInputElement の value 値の増減値を文字列で取得/設定します。

HTMLの step 属性を反映しています。

HTMLInputElement.valueAsDate
HTMLInputElement の値を日付として解釈した Date オブジェクトを返します。

type が date の場合に対応?。

HTMLInputElement.valueAsNumber
HTMLInputElement の値を数値として解釈して返します。

type の中で、数値として扱うタイプでないとだめなようです。→推奨: JavaScript:Number()

HTMLInputElement.autocapitalize 実験的
HTMLInputElement の入力を大文字化する動作を文字列で取得/設定します。

HTMLの autocapitalize を反映しています。

HTMLInputElement.inputmode
HTMLInputElement の入力を編集する際に使用する仮想キーボード設定の種類についてブラウザーへのヒントを文字列で取得/設定します。

HTMLの inputmode を反映しています。

その他のプロパティ
HTMLInputElement.align 非推奨
文字列。要素の配置を表します。代わりに CSS を使用してください。
HTMLInputElement.capture [Edge]⛌
HTMLInputElement.useMap 非推奨
文字列。クライアント側イメージマップを表します。
メソッド
HTMLInputElement.select()
HTMLInputElement の値のテキストを全て選択します。
HTMLInputElement.setSelectionRange(selectionStart, selectionEnd[, selectionDirection])
HTMLInputElement のテキストの中を範囲選択します。フォーカスは与えません。

このメソッドの呼び出しにより、selectionStartselectionEndselectionDirection の各プロパティは更新されます。

HTMLInputElement.setRangeText(replacement[, start, end[, selectMode]])
HTMLInputElement のテキストの内容を指定範囲の部分だけ指定文字列で置換します。
HTMLInputElement.setCustomValidity(message)
HTMLInputElement にカスタム検証メッセージを設定します。
HTMLInputElement.showPicker()
HTMLInputElement のピッカーを表示します。※ ピッカー:入力するために表示物?。

type が date、month、week、time、datetime-local、color、file の場合に適用されます。

IFRAME の中ではできないようです。

HTMLInputElement.checkValidity()
HTMLInputElement の値を検証して妥当かどうかを論理値で返します。

値が無効である場合は、その要素で invalid イベントが発行されます。

HTMLInputElement.reportValidity()
HTMLInputElementcheckValidity() メソッドと同じ手順で検証し、問題があればその結果を表示します。
その他のメソッド
HTMLInputElement.stepDown([stepDecrement])
HTMLInputElementstep 属性値の指定分だけ value 値を減少させます。

step に対応している type の date、month、week、time、datetime-local、number、range に有効です。

HTMLInputElement.stepUp([stepIncrement])
HTMLInputElementstep 属性値の指定分だけ value 値を増加させます。

step に対応している type の date、month、week、time、datetime-local、number、range に有効です。

HTMLInputElement.mozSetFileArray() 非標準 [Edge]⛌?
入力欄で選択されたファイルを、与えられた File オブジェクトの配列に設定します。これは、フレーム スクリプトで使用可能な mozSetFileNameArray() の代替となるものです。クローム スクリプトはファイルを File オブジェクトとして開き、メッセージ マネージャーを介してそれらを送信することができます。
HTMLInputElement.mozGetFileNameArray(aLength, aFileNames) 非標準 [Edge]⛌?
その入力欄からすべてのファイル名の配列を返します。
イベント

以下のイベントは、addEventListener() を用いるか、このインターフェイスの onイベント名 プロパティにイベントリスナーを割り当てるかして待ち受けしてください。

cancel 実験的 [Edge]⛌
input
value が変更されたときに発生します。

oninput イベント ハンドラー プロパティからも利用できます。

このイベントは実際には HTMLElement インターフェイス上で発生します。

invalid
value を検証したときに、結果、満たしていなかった場合に発生します。

oninvalid イベント ハンドラー プロパティからも利用できます。

このイベントは実際には HTMLElement インターフェイス上で発生します。

search
実際に検索操作([Enter]押下)が行われたときに発行されます。

type が search の場合に有効です。

onsearch イベント ハンドラー プロパティからも利用できます。

selectionchange 実験的 [Edge]⛌

テスト