accept
file
入力タイプにのみ有効です。 accept
属性は、file
アップロードコントロールで選択可能なファイルタイプを定義します。ファイル入力タイプを参照してください。
alt
image
ボタンでのみ有効、alt
属性は、画像の代替テキストを提供し、画像src
が欠落しているか、ロードに失敗した場合に属性の値を表示します。画像入力タイプを参照してください。
autocomplete
(ブール属性ではありません!)autocomplete
属性はその値として使用されます入力が提供するオートコンプリート機能のタイプを説明する、スペースで区切られた文字列。オートコンプリートの一般的な実装では、同じ入力フィールドに入力された以前の値が呼び出されますが、より複雑な形式のオートコンプリートが存在する可能性があります。たとえば、ブラウザをデバイスの連絡先リストと統合して、メール入力フィールドのemail
アドレスをオートコンプリートできます。許可される値については、HTMLオートコンプリート属性の値を参照してください。
autocomplete
属性はhidden
、text
、search
、url
、tel
、email
、date
、month
、week
、time
、 datetime-local
、number
、range
、color
、およびpassword
。この属性は、数値またはテキストデータを返さない入力タイプには影響せず、checkbox
、radio
、file
、または任意のボタンタイプ。
HTMLオートコンプリート属性fを参照してください。または、パスワードのセキュリティに関する情報や、hidden
と他の入力タイプのautocomplete
の違いなどの追加情報。
autofocus
ブール属性。存在する場合、ページの読み込みが完了したとき(または<dialog>
が表示されています。
注:autofocus
属性を持つ要素は、イベントが発生します。
ドキュメント内の複数の要素にautofocus
属性を含めることはできません。複数の要素を配置すると、属性を持つ最初の要素がフォーカスを受け取ります。
autofocus
属性は、タイプ、非表示の入力にフォーカスできないため。
警告:フォームコントロールに自動的にフォーカスすると、画面読み上げテクノロジーを使用している視覚障害者や認知障害のある人を混乱させる可能性があります。 autofocus
が割り当てられている場合、スクリーンリーダーは、事前に警告することなく、ユーザーをフォームコントロールに「テレポート」します。
アクセシビリティについては、慎重に検討してください。 autofocus
属性を適用します。コントロールに自動的に焦点を合わせると、読み込み時にページがスクロールする可能性があります。フォーカスにより、一部のタッチデバイスでダイナミックキーボードが表示される場合もあります。スクリーンリーダーはフォーカスを受け取るフォームコントロールのラベルをアナウンスしますが、スクリーンリーダーはラベルの前に何もアナウンスしません。また、小さなデバイスを使用している目の見えるユーザーは、前のコンテンツによって作成されたコンテキストを同様に見逃します。
capture
HTML Media Capture仕様で導入され、file
入力タイプcapture
属性は、サポートシナリオでfile
アップロードコントロールを使用してアップロードする新しいファイルをキャプチャするために使用するメディア(マイク、ビデオ、またはカメラ)を定義します。ファイルの入力タイプを確認してください。
checked
radio
とcheckbox
タイプ、checked
はブール属性です。 radio
タイプに存在する場合、ラジオボタンが同じ名前のラジオボタンのグループで現在選択されているものであることを示します。 checkbox
タイプに存在する場合、チェックボックスがデフォルトでチェックされていることを示します(ページが読み込まれるとき)。このチェックボックスが現在チェックされているかどうかは示されません。チェックボックスの状態が変更された場合、このコンテンツ属性は変更を反映しません。 (HTMLInputElement
のchecked
IDL属性のみが更新されます。)
注:他の入力コントロールとは異なり、チェックボックスとラジオボタンの値は、現在checked
である場合にのみ送信データに含まれます。そうである場合、チェックされたコントロールの名前と値が送信されます。
たとえば、name
がfruit
にはvalue
のcherry
があり、チェックボックスがオンになっていると、送信されるフォームデータに
。チェックボックスがアクティブでない場合、フォームデータにはまったく表示されません。チェックボックスとラジオボタンのデフォルトのvalue
はon
です。
dirname
text
およびsearch
入力タイプに対してのみ有効、dirname
属性は、要素の方向性の送信を有効にします。含まれている場合、フォームコントロールは2つの名前と値のペアで送信されます。1つ目はname
とvalue
で、2つ目は値です。 dirname
の値がltr
またはrtl
の値で設定されている名前ブラウザ。
上記のフォームを送信すると、入力によってname
/ value
のペアのfruit=cherry
とdirname
/送信するfruit.dir=ltr
の方向ペア。
disabled
ブール属性。存在する場合、ユーザーが入力を操作できないようにする必要があることを示します。無効にされた入力は通常、薄暗い色でレンダリングされるか、フィールドが使用できないことを示す他の形式を使用してレンダリングされます。
具体的には、無効にされた入力はclick
イベント、および無効化された入力はフォームで送信されません。
注:仕様では必須ではありませんが、Firefoxはデフォルトでページの読み込み全体。この機能を制御するには、autocomplete
属性を使用します。
form
<form>
要素のid
と一致する必要があります。この属性が「t」でない場合指定すると、<input>
要素は最も近い包含フォームに関連付けられます。
form
属性を使用すると入力はドキュメント内の任意の場所に配置しますが、フォームにはドキュメント内の他の場所に含めます。
注:入力は1つのフォームにのみ関連付けることができます。
formaction
image
およびsubmit
入力タイプにのみ有効です。詳細については、送信入力タイプを参照してください。
formenctype
image
およびsubmit
入力タイプのみ。詳細については、送信入力タイプを参照してください。
formmethod
image
およびsubmit
入力タイプのみ。詳細については、送信入力タイプを参照してください。
formnovalidate
image
およびsubmit
入力タイプのみ。詳細については、送信入力タイプを参照してください。
formtarget
image
およびsubmit
入力タイプのみ。詳細については、送信入力タイプを参照してください。
height
image
入力ボタンでのみ有効です。height
は、グラフィカルな送信ボタンを表すために表示する画像ファイルの高さです。画像入力タイプを参照してください。
id
すべての入力タイプを含むすべての要素に有効なグローバル属性。一意である必要がある一意の識別子(ID)を定義します。ドキュメント全体で。その目的は、リンクするときに要素を識別することです。この値は、<label>
のfor
属性の値として使用され、ラベルをフォームコントロールにリンクします。<label>
。
inputmode
すべての要素に有効なグローバル値であり、仮想キーボード構成のタイプに関するヒントをブラウザに提供します。この要素またはそのコンテンツを編集するときに使用します。値には、none
、text
、tel
、 url
、email
、numeric
、decimal
、およびsearch
。
list
list
属性に指定する値はid
同じドキュメントにある<datalist>
要素のdiv>。 <datalist>
は、この入力についてユーザーに提案する定義済みの値のリストを提供します。 type
と互換性のないリスト内の値は、推奨オプションに含まれていません。提供される値は提案であり、要件ではありません。ユーザーはこの事前定義されたリストから選択するか、別の値を提供できます。
text
、search
、url
、tel
、email
、date
、month
、week
、time
、 datetime-local
、number
、range
、およびcolor
。
仕様により、list
属性はhidden
、password
、checkbox
、radio
、file
、またはその他
ブラウザによっては、提案されたカスタムカラーパレット、範囲に沿った目盛り、または<select>
ただし、リストされていないvaを許可しますルーズ。他の入力タイプについては、ブラウザの互換性テーブルを確認してください。
<datalist>
要素を参照してください。
max
date
、month
、week
、、datetime-local
、number
、およびrange
は、許可された値の範囲内の最大値。要素に入力されたvalue
がこれを超えると、要素は制約の検証に失敗します。 max
属性の値が数値でない場合、要素には最大値がありません。
特殊なケースがあります:データ型が周期的である場合(日付や時刻など)、max
の値がmin
の値よりも小さい場合があります。これは、範囲がラップアラウンド。たとえば、これにより、午後10時から午前4時までの時間範囲を指定できます。
maxlength
text
、search
、url
、tel
、email
、およびpassword
は、ユーザーがフィールドに入力できる最大文字数(UTF-16コード単位として)を定義します。これは整数値である必要があります。 0
以上。maxlength
が指定されていない場合、または無効な値が指定されている場合、フィールドの最大長はありません。この値も必要です。
フィールドに入力されたテキストの長さがmaxlength
より大きい場合、入力は制約の検証に失敗します。 UTF-16コードユニットの長さ。デフォルトでは、ブラウザは、ユーザーがmaxlength
属性で許可されているよりも多くの文字を入力できないようにします。詳細については、クライアント側の検証を参照してください。
min
date
、、week
、time
、datetime-local
、number
およびrange
は、許可された値の範囲内で最も負の値を定義します。要素に入力されたvalue
がこれよりも小さい場合、要素は制約の検証に失敗します。 min
属性の値が数値でない場合、要素には最小値がありません。
この値は、の値以下である必要があります。 max
属性。min
属性は存在するが、指定されていないか無効である場合、min
値が適用されます。min
属性が有効で、空でない値がmin
で許可されている最小値よりも小さい場合属性、制約の検証により、フォームの送信が防止されます。詳細については、クライアント側の検証を参照してください。
特殊なケースがあります。データタイプが定期的(日付や時刻など)の場合、 はmin
の値よりも小さい場合があります。これは、範囲が折り返される可能性があることを示します。たとえば、これにより時間を指定できます。範囲は午後10時から午前4時までです。
minlength
text
、search
、tel
、email
、およびpassword
、これは、ユーザーが入力フィールドに入力できる最小文字数(UTF-16コード単位として)を定義します。これは、maxlength
で指定された値以下の負でない整数値である必要があります。 minlength
が指定されていない場合、または無効な値が指定されている場合、入力には最小長がありません。
テキストの長さが次の場合、入力は制約検証に失敗します。フィールドに入力するのはminlength
UTF-16コード単位よりも短いため、フォームを送信できません。詳細については、クライアント側の検証を参照してください。
multiple
ブール値のmultiple
属性が設定されている場合は、ユーザーを意味します。メールウィジェットにカンマ区切りのメールアドレスを入力するか、file
入力を使用して複数のファイルを選択できます。電子メールとファイルの入力タイプを参照してください。
name
入力コントロールの名前を指定する文字列。この名前は、フォームデータが送信されるときに、コントロールの値とともに送信されます。
名前の内容
name
必須属性(そうでない場合でも)。入力にname
が指定されていない場合、またはname
が空の場合、入力の値はフォームで送信されません! (無効なコントロール、チェックされていないラジオボタン、チェックされていないチェックボックス、リセットボタンも送信されません。)
2つの特殊なケースがあります:
-
_charset_
:タイプhiddenの<input>
要素の名前として使用される場合、入力のvalue
はによって自動的に設定されます。フォームの送信に使用されている文字エンコーディングのユーザーエージェント。 -
isindex
:歴史的な理由から、名前isindex
は許可されていません。
名前とラジオボタン
name
属性は、ラジオボタンに固有の動作を作成します。
一度にチェックできるラジオボタンの同じ名前のグループ内の1つのラジオボタンのみ。そのグループ内のラジオボタンを選択すると、同じグループ内の現在選択されているラジオボタンの選択が自動的に解除されます。フォームが送信されると、チェックされた1つのラジオボタンが名前とともに送信されます。
一連の同じボタンにタブで移動する場合-ラジオボタンの名前付きグループ。1つがチェックされている場合、そのボタンはフォーカスを受け取ります。ソース順にグループ化されていない場合、グループの1つがチェックされていると、グループ内の最初のグループが検出されたときにグループへのタブ移動が開始され、チェックされていないものはすべてスキップされます。つまり、1つがチェックされている場合、タブを押すと、グループ内のチェックされていないラジオボタンがスキップされます。何もチェックされていない場合、同じ名前グループの最初のボタンに到達すると、ラジオボタングループがフォーカスを受け取ります。
グループ内のラジオボタンの1つにフォーカスがあると、矢印キーを使用してすべてをナビゲートします。ラジオボタンがソース順にグループ化されていない場合でも、同じ名前のラジオボタン。
HTMLFormElement.elements
入力要素にname
の場合、その名前は所有するフォーム要素のHTMLFormElement.elements
プロパティのプロパティになります。name
はguest
に設定され、name
がhat-size
である別のコードは、次のコードです。使用可能:
このコードが実行されると、guestName
はivid = “59773fad9c guest
フィールドの場合は “> 、hat-size
divの場合はhatSize
>フィールド。
警告:フォーム要素に、フォームの組み込みプロパティに対応するname
を指定しないでください。対応する入力へのこの参照を使用して、事前定義されたプロパティまたはメソッドをオーバーライドするためです。
pattern
pattern
属性は、指定されている場合、次の正規表現です。値が制約検証に合格するには、入力のvalue
が一致する必要があります。 RegExp
タイプで使用され、正規表現に関するガイドに記載されているように、有効なJavaScript正規表現である必要があります。 "u"
フラグは正規表現のコンパイル時に指定されるため、パターンはASCIIではなくUnicodeコードポイントのシーケンスとして扱われます。パターンテキストの前後にスラッシュを指定しないでください。
pattern
属性が存在するが、指定されていないか無効である場合、正規表現は適用されず、これは属性は完全に無視されます。パターン属性が有効で、空でない値がパターンと一致しない場合、制約の検証によりフォームの送信が防止されます。
ヒント:pattern
属性。近くに説明テキストを含めて、予想される形式についてユーザーに通知します。 title
属性を含めて、パターンに一致するための要件を説明することもできます。ほとんどのブラウザは、このタイトルをツールチップとして表示します。アクセシビリティには、目に見える説明が必要です。ツールチップは拡張機能です。
詳細については、クライアント側の検証を参照してください。
placeholder
placeholder
属性は、フィールドでどのような種類の情報が期待されるかについてユーザーに簡単なヒントを提供する文字列です。説明やプロンプトではなく、予想されるデータの種類に関するヒントを提供する単語または短いフレーズである必要があります。テキストには、キャリッジリターンやラインフィードを含めないでください。したがって、たとえば、フィールドがユーザーの名をキャプチャすることが期待され、そのラベルが「名」である場合、適切なプレースホルダーは「たとえば、 Mustafa “。
注:placeholder
属性は、フォームを説明する他の方法ほど意味的には有用ではなく、予期しない技術的な問題を引き起こす可能性があります。コンテンツ。詳細については、< input >のラベル:入力(フォーム入力)要素を参照してください。
readonly
ブール属性。存在する場合、ユーザーが入力の値を編集できないようにする必要があることを示します。readonly
属性がサポートされていますtext
、search
、url
、tel
、email
、date
、month
、week
、time
、datetime-local
、number
、およびpassword
入力タイプ。
詳細については、HTML属性readonly
を参照してください。
required
はブール属性であり、存在する場合、所有するフォームを送信する前に、ユーザーが入力の値を指定する必要があることを示します。 required
属性は、text
、search
、、tel
、email
、date
、month
、week
、time
、datetime-local
、number
、password
、checkbox
、radio
、およびfile
入力。
詳細については、クライアント側の検証とHTML属性required
を参照してください。
size
email
、password
、tel
、およびtext
input
タイプのみ。表示される入力の量を指定します。基本的に、CSSwidth
プロパティを設定するのと同じ結果をいくつかの特殊性で作成します。値の実際の単位は、入力タイプによって異なります。password
およびtext
の場合、これは文字数(またはem
単位)であり、デフォルト値は20
で、その他の場合はpixel
です。 CSSの幅はサイズ属性よりも優先されます。src
image
入力ボタンにのみ有効です。src
は文字列を指定しますグラフィカルな送信ボタンを表すために表示する画像ファイルのURL。画像入力タイプを参照してください。
step
number
、日付などの数値入力タイプに有効です/ time入力タイプ、およびrange
、step
属性は、値が準拠する必要のある粒度を指定する数値です。
明示的に含まれていない場合:
-
step
のデフォルトはnumber
とrange
。 - 日付/時刻の入力タイプの場合、
step
は秒で表され、デフォルトのステップは60秒です。 。ステップスケール係数は1000です(他のアルゴリズムで使用されるように、秒をミリ秒に変換します)。
値は正の数(整数または浮動小数点数)または特別な値
は、ステッピングが暗黙指定されておらず、任意の値が許可されていることを意味します(min
やmax
)。
any
が明示的に設定されていない場合、number
、日付/時刻入力タイプ、および
入力タイプは、ステップの基準と同じです—min
値とステップ値の増分(値(指定されている場合)。
たとえば、<input type="number" min="10" step="2">
がある場合は、任意の偶数の整数10
以上が有効です。 <input type="number">
を省略した場合、任意の整数は有効ですが、iv id = “817c131ab3″のため、float(4.2
など)は無効です。 > のデフォルトは1
です。 4.2
を有効にするには、step
をany
、0.1に設定する必要があります。 、0.2、またはmin
の値は、iv id = “a4ce6d93e9″など、.2
で終わる数値である必要があります。 >
注:ユーザーが入力したデータがステッピング構成に準拠していない場合、値は制約検証で無効と見なされ、疑似クラス。
詳細については、クライアント側の検証を参照してください。
tabindex
すべての入力タイプを含むすべての要素に有効なグローバル属性、要素が入力フォーカスを取得できるかどうか(フォーカス可能)、シーケンシャルキーボードナビゲーションに参加する必要があるかどうかを示す整数属性。非表示タイプの入力を除くすべての入力タイプとしてフォーカス可能である場合、この属性はフォームコントロールで使用しないでください。使用すると、フォーカスの管理が必要になるためです。ドキュメント内のすべての要素を注文しますが、正しく行わないと、使いやすさとアクセシビリティが損なわれるリスクがあります。
title
すべての入力タイプを含むすべての要素に有効なグローバル属性、それが属する要素に関連する助言情報を表すテキストが含まれています。このような情報は、通常、必ずしもそうとは限りませんが、ツールチップとしてユーザーに提示できます。タイトルは、フォームコントロールの目的の主要な説明として使用しないでください。代わりに、<label>
要素を使用してfor
属性をフォームコントロールのid
属性。以下のラベルを参照してください。
type
レンダリングするコントロールのタイプを指定する文字列。たとえば、チェックボックスを作成するには、text
が使用され、プレーンテキストの入力フィールドが作成されます。
許可される値は上記の<input>
タイプにリストされています。
value
入力コントロールの値。 HTMLで指定されている場合、これは初期値であり、それ以降は、JavaScriptを使用していつでも変更または取得して、それぞれのHTMLInputElement
オブジェクトのvalue
プロパティ。value
属性は常にオプションですが、checkbox
、hidden
。
width
image
入力ボタンのみ、width
は、グラフィカルな送信ボタンを表すために表示する画像ファイルの幅です。画像入力タイプを参照してください。