HTMLInputElement HTMLInputElement
インターフェイスは <input>
要素のオプション、レイアウト、表示方法を操作するための特別なプロパティやメソッドを提供します。
EventTarget
Node
Element
HTMLElement
HTMLInputElement
hidden 以外のあらゆる型の input 要素に適用されるプロパティ
name
文字列: その要素の name
属性を返却または設定 します。ここにはフォーム送信時にその要素を識別する名前が入ります。
type
文字列: その要素の type
属性を返却または設定 します。これは表示するコントロールの型を示します。利用可能な値については <input>
の type
属性を参照してください。
disabled
(en-US)
論理値: その要素の disabled
属性を返却または設定 します。これはそのコントロールが対話を受け付けないかどうかを示します。その入力値はフォームとともに送信されません。 readonly
もご覧ください。
autofocus
論理値: その要素の autofocus
属性を返却または設定 します。ページが読み込まれたときに、ユーザーが別のコントロールに入力するなどしてそれを上書きしない限り、そのフォームコントロールが入力フォーカスを持つべきであることを指定します。文書内の一つの form 要素だけが autofocus
属性を持つことができます。 type
属性が hidden
に設定されている場合には適用できません (つまり、非表示のコントロールにフォーカスを自動的に設定することはできません)。
required
論理値: その要素の required
属性を返却または設定 します。これは、フォームを送信する前にユーザーが値を入力しなければならないかどうかを示します。
value
文字列: そのコントロールの現在の値を返却または設定 します。
注: ユーザーが予期しない値を入力した場合、これは空文字列を返すことがあります。
validity
読取専用
ValidityState
オブジェクト: その要素の現在の検証状態を返します 。
validationMessage
読取専用
文字列: 制約検証をそのコントロールが満たさなかった場合、それを記述したローカライズされたメッセージを返します (もしあれば)。これは、コントロールが制約検証の候補ではない場合 (willvalidate
が false
の場合)、または制約を満たしている場合は空の文字列です。この値は、 setCustomValidity
メソッドで設定できます。
willValidate
読取専用
論理値: その要素が制約検証の候補であるかどうかを返します 。これは何か制約検証を阻む条件がある場合、例えば、 `type` が hidden
、reset
、`button` のいずれかである、祖先に <datalist>
がある、 `disabled` プロパティが `true` である、などです。
checkbox
または radio
型の要素にのみに適用できるプロパティ
checked
論理値: type
が checkbox
または radio
の場合、要素の現在の状態を返却または設定 します。
defaultChecked
論理値: このオブジェクトを生成した HTML でもともと指定されていたラジオボタンまたはチェックボックスの既定の状態を返却または設定 します。
indeterminate
論理値: チェックボックスやラジオボタンの状態が不確定であるかどうかを返します 。チェックボックスの場合は、その状態が不確定 (チェックでも未チェックでもない状態) であることを示すために、チェックボックスの外観が何らかの方法で不明瞭になったり、灰色になったりする効果があります。 checked
属性の値には影響を与えず、チェックボックスをクリックするとその値は false になります。
image
型の要素のみに適用できるプロパティ
alt
文字列: type
が image
である場合、その要素の代替テキストが設定された alt
属性を返却または設定 します。
height
文字列: type
の値が image
である場合、ボタンに表示される画像の高さを定義するその要素の height
属性を返却または設定 します。
src
文字列: type
の値が image
である場合、グラフィックの送信ボタンを表示する画像の場所を示す URI を指定する、その要素の src
属性を返却または設定 します。それ以外の場合は無視されます。
width
文字列: type
の値が image
である場合、ボタンに表示される画像の幅を定義する、文書の width
属性を返却または設定 します。
text/number
を含む型の要素のみに適用できるプロパティ
autocomplete
文字列: その要素の autocomplete
属性を返却または設定 します。これはコントロールの値をブラウザーで自動的に補完できるかどうかを示します。 type
属性の値が hidden
、checkbox
、radio
、file
、またはボタン型 (button
、submit
、reset
、image
) の場合は無視されます。可能な値は次の通りです。on
: ブラウザーが以前入力された値を使用して値を自動補完することができるoff
: ユーザーは明示的に値を入力しなければならない
max
文字列: その要素の max
属性を返却または設定 します。この属性には、この項目の (数値または日時の) 最大値が含まれ、最小値 (min
属性) より小さくすることはできません。
maxLength
long
: その要素の maxlength
属性を返却または設定 します。この属性には、値が持つことのできる (Unicode コードポイントでの) 最大文字数 が含まれます。 (これを負の数に設定した場合、例外が発生します。)
min
文字列: その要素の min
属性を返却または設定 します。この属性には、この項目の (数値または日時の) 最小値が含まれ、最大値 (max
属性) より大きくすることはできません。
minLength
long
: その要素の minlength
属性を返却または設定 します。この属性には、値が持つことのできる (Unicode コードポイントでの) 最小文字数 が含まれます。 (これを負の数に設定した場合、例外が発生します。)
pattern
文字列: その要素の pattern
属性を返却または設定 します。ここにはコントロールの値をチェックするための正規表現 を含みます。 title
属性を使用してユーザーにパターンを説明してください。この属性は、 type
属性の値が text
、search
、tel
、url
、email
の場合に適用され、それ以外の場合は無視されます。
placeholder
文字列: その要素の placeholder
属性を返却または設定 します。ここには、ユーザーがコントロールに何を入力できるかのヒントが設定されます。プレイスホルダーのテキストには、キャリッジリターンやラインフィードを含むことはできません。この属性は、 type
属性の値が text
、search
、tel
、url
、email
の場合に適用され、それ以外の場合は無視されます。
readOnly
論理値: その要素の readonly
属性を返却または設定 します。これは、ユーザーがコントロールの値を変更できないことを示します。type
属性の値が hidden
、range
、color
、checkbox
、radio
、file
、またはボタン型の場合は無視されます。
selectionStart
unsigned long
: 選択中のテキストの先頭の位置を返却または設定 します。何も選択していない場合は、その <input>
要素内にあるテキスト入力カーソル (キャレット) の位置を返します。
selectionEnd
unsigned long
: 選択中のテキストの末尾の位置を返却または設定 します。選択がない場合は、現在のテキスト入力カーソル位置の直後の文字のオフセットを返します。
selectionDirection
文字列: 選択が行われた方向を返却または設定 します。可能な値は次のとおりです。forward
は現在のロケールにおいての先頭から末尾の方向で選択された場合backward
は逆方向の場合none
は方向が不明な場合
size
unsigned long
: その要素の size
属性を返却または設定 します。これはコントロールの外見の大きさ が入ります。この値は type
の値が text
または password
の場合は整数で文字数であり、それ以外の場合はピクセル単位です。 type
が text
、search
、tel
、url
、email
、password
のいずれかに設定されている場合のみ適用され、それ以外の場合は無視されます。
未分類のプロパティ
defaultValue
文字列: このオブジェクトを生成した HTML で最初に指定された既定値を返却または設定 します。
dirName
文字列: 要素の書字方向を返却または設定 します。
accessKey
文字列: 押されるとコントロールへの入力フォーカスを切り替える単一の文字が入った文字列を返します 。
list
読取専用
HTMLElement
オブジェクト: list
属性が指す要素を返します 。同じツリーに HTML 要素がない場合、プロパティは null
になることがあります。
multiple
論理値: その要素の multiple
属性を返却または設定 します。これは複数の値 (例えば複数のファイル) を持つことが可能であるかどうかを示します。
files
FileList
の配列: 選択されたファイルのリストを返します 。
labels
読取専用
NodeList
の配列: この要素のラベルである <label>
要素のリストを返します 。
step
文字列: その要素の step
属性を返却または設定 します。これは、 min
や max
と共に、数値や日時の値を設定する際の増分を制限します。文字列 any
または正の浮動小数点数を設定することができます。 any
が設定されていない場合、コントロールは最小値よりも大きい step 値の倍数のみを受け入れます。
valueAsDate
Date
オブジェクト: その要素の値を、日時として解釈して返却または設定 します。変換が不可能であれば null
を返します。
valueAsNumber
double
: その要素の値を、次のいずれかのうち一つとして解釈して返します 。解釈は以下の順で行われます。
autocapitalize
Experimental
文字列: ユーザーの入力を大文字化する動作を定義します 。有効な値は none
, off
, characters
, words
, sentences
です。
inputmode
この要素またはその内容を編集する際に使用する仮想キーボード設定の種類について、ブラウザーにヒントを与えます。
align
非推奨
文字列: 要素の配置を表します 。代わりに CSS を使用してください。
useMap
非推奨
文字列: クライアント側イメージマップを表します 。
BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.