:入力(フォーム入力)要素

accept

file入力タイプにのみ有効です。 accept属性は、fileアップロードコントロールで選択可能なファイルタイプを定義します。ファイル入力タイプを参照してください。

alt

imageボタンでのみ有効、alt属性は、画像の代替テキストを提供し、画像srcが欠落しているか、ロードに失敗した場合に属性の値を表示します。画像入力タイプを参照してください。

autocomplete

(ブール属性ではありません!)autocomplete属性はその値として使用されます入力が提供するオートコンプリート機能のタイプを説明する、スペースで区切られた文字列。オートコンプリートの一般的な実装では、同じ入力フィールドに入力された以前の値が呼び出されますが、より複雑な形式のオートコンプリートが存在する可能性があります。たとえば、ブラウザをデバイスの連絡先リストと統合して、メール入力フィールドのemailアドレスをオートコンプリートできます。許可される値については、HTMLオートコンプリート属性の値を参照してください。

autocomplete属性はhiddentextsearchurltelemaildatemonthweektimedatetime-localnumberrangecolor、およびpassword。この属性は、数値またはテキストデータを返さない入力タイプには影響せず、checkboxradiofile、または任意のボタンタイプ。

HTMLオートコンプリート属性fを参照してください。または、パスワードのセキュリティに関する情報や、hiddenと他の入力タイプのautocompleteの違いなどの追加情報。

autofocus

ブール属性。存在する場合、ページの読み込みが完了したとき(または<dialog>が表示されています。

注:autofocus属性を持つ要素は、イベントが発生します。

ドキュメント内の複数の要素にautofocus属性を含めることはできません。複数の要素を配置すると、属性を持つ最初の要素がフォーカスを受け取ります。

autofocus属性は、タイプ、非表示の入力にフォーカスできないため。

警告:フォームコントロールに自動的にフォーカスすると、画面読み上げテクノロジーを使用している視覚障害者や認知障害のある人を混乱させる可能性があります。 autofocusが割り当てられている場合、スクリーンリーダーは、事前に警告することなく、ユーザーをフォームコントロールに「テレポート」します。

アクセシビリティについては、慎重に検討してください。 autofocus属性を適用します。コントロールに自動的に焦点を合わせると、読み込み時にページがスクロールする可能性があります。フォーカスにより、一部のタッチデバイスでダイナミックキーボードが表示される場合もあります。スクリーンリーダーはフォーカスを受け取るフォームコントロールのラベルをアナウンスしますが、スクリーンリーダーはラベルの前に何もアナウンスしません。また、小さなデバイスを使用している目の見えるユーザーは、前のコンテンツによって作成されたコンテキストを同様に見逃します。

capture

HTML Media Capture仕様で導入され、file入力タイプcapture属性は、サポートシナリオでfileアップロードコントロールを使用してアップロードする新しいファイルをキャプチャするために使用するメディア(マイク、ビデオ、またはカメラ)を定義します。ファイルの入力タイプを確認してください。

checked

radiocheckboxタイプ、checkedはブール属性です。 radioタイプに存在する場合、ラジオボタンが同じ名前のラジオボタンのグループで現在選択されているものであることを示します。 checkboxタイプに存在する場合、チェックボックスがデフォルトでチェックされていることを示します(ページが読み込まれるとき)。このチェックボックスが現在チェックされているかどうかは示されません。チェックボックスの状態が変更された場合、このコンテンツ属性は変更を反映しません。 (HTMLInputElementchecked IDL属性のみが更新されます。)

注:他の入力コントロールとは異なり、チェックボックスとラジオボタンの値は、現在checkedである場合にのみ送信データに含まれます。そうである場合、チェックされたコントロールの名前と値が送信されます。

たとえば、namefruitにはvaluecherryがあり、チェックボックスがオンになっていると、送信されるフォームデータに

。チェックボックスがアクティブでない場合、フォームデータにはまったく表示されません。チェックボックスとラジオボタンのデフォルトのvalueonです。

dirname

textおよびsearch入力タイプに対してのみ有効、dirname属性は、要素の方向性の送信を有効にします。含まれている場合、フォームコントロールは2つの名前と値のペアで送信されます。1つ目はnamevalueで、2つ目は値です。 dirnameの値がltrまたはrtlの値で設定されている名前ブラウザ。

上記のフォームを送信すると、入力によってname / valueのペアのfruit=cherrydirname /送信する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

すべての要素に有効なグローバル値であり、仮想キーボード構成のタイプに関するヒントをブラウザに提供します。この要素またはそのコンテンツを編集するときに使用します。値には、nonetexttelurlemailnumericdecimal、およびsearch

list

list属性に指定する値はid同じドキュメントにある<datalist>要素のdiv>。 <datalist>は、この入力についてユーザーに提案する定義済みの値のリストを提供します。 typeと互換性のないリスト内の値は、推奨オプションに含まれていません。提供される値は提案であり、要件ではありません。ユーザーはこの事前定義されたリストから選択するか、別の値を提供できます。

textsearchurltelemaildatemonthweektimedatetime-localnumberrange、およびcolor

仕様により、list属性はhiddenpasswordcheckboxradiofile、またはその他

ブラウザによっては、提案されたカスタムカラーパレット、範囲に沿った目盛り、または<select>ただし、リストされていないvaを許可しますルーズ。他の入力タイプについては、ブラウザの互換性テーブルを確認してください。

<datalist>要素を参照してください。

max

datemonthweek、、datetime-localnumber、およびrangeは、許可された値の範囲内の最大値。要素に入力されたvalueがこれを超えると、要素は制約の検証に失敗します。 max属性の値が数値でない場合、要素には最大値がありません。

特殊なケースがあります:データ型が周期的である場合(日付や時刻など)、maxの値がminの値よりも小さい場合があります。これは、範囲がラップアラウンド。たとえば、これにより、午後10時から午前4時までの時間範囲を指定できます。

maxlength

textsearchurltelemail、およびpasswordは、ユーザーがフィールドに入力できる最大文字数(UTF-16コード単位として)を定義します。これは整数値である必要があります。 0以上。maxlengthが指定されていない場合、または無効な値が指定されている場合、フィールドの最大長はありません。この値も必要です。

フィールドに入力されたテキストの長さがmaxlengthより大きい場合、入力は制約の検証に失敗します。 UTF-16コードユニットの長さ。デフォルトでは、ブラウザは、ユーザーがmaxlength属性で許可されているよりも多くの文字を入力できないようにします。詳細については、クライアント側の検証を参照してください。

min

date、、weektimedatetime-localnumberおよびrangeは、許可された値の範囲内で最も負の値を定義します。要素に入力されたvalueがこれよりも小さい場合、要素は制約の検証に失敗します。 min属性の値が数値でない場合、要素には最小値がありません。

この値は、の値以下である必要があります。 max属性。min属性は存在するが、指定されていないか無効である場合、min値が適用されます。min属性が有効で、空でない値がminで許可されている最小値よりも小さい場合属性、制約の検証により、フォームの送信が防止されます。詳細については、クライアント側の検証を参照してください。

特殊なケースがあります。データタイプが定期的(日付や時刻など)の場合、 はminの値よりも小さい場合があります。これは、範囲が折り返される可能性があることを示します。たとえば、これにより時間を指定できます。範囲は午後10時から午前4時までです。

minlength

textsearchtelemail、およびpassword、これは、ユーザーが入力フィールドに入力できる最小文字数(UTF-16コード単位として)を定義します。これは、maxlengthで指定された値以下の負でない整数値である必要があります。 minlengthが指定されていない場合、または無効な値が指定されている場合、入力には最小長がありません。

テキストの長さが次の場合、入力は制約検証に失敗します。フィールドに入力するのはminlength UTF-16コード単位よりも短いため、フォームを送信できません。詳細については、クライアント側の検証を参照してください。

multiple

ブール値のmultiple属性が設定されている場合は、ユーザーを意味します。メールウィジェットにカンマ区切りのメールアドレスを入力するか、file入力を使用して複数のファイルを選択できます。電子メールとファイルの入力タイプを参照してください。

name

入力コントロールの名前を指定する文字列。この名前は、フォームデータが送信されるときに、コントロールの値とともに送信されます。

名前の内容

name必須属性(そうでない場合でも)。入力にnameが指定されていない場合、またはnameが空の場合、入力の値はフォームで送信されません! (無効なコントロール、チェックされていないラジオボタン、チェックされていないチェックボックス、リセットボタンも送信されません。)

2つの特殊なケースがあります:

  1. _charset_:タイプhiddenの<input>要素の名前として使用される場合、入力のvalueはによって自動的に設定されます。フォームの送信に使用されている文字エンコーディングのユーザーエージェント。
  2. isindex:歴史的な理由から、名前isindexは許可されていません。
名前とラジオボタン

name属性は、ラジオボタンに固有の動作を作成します。

一度にチェックできるラジオボタンの同じ名前のグループ内の1つのラジオボタンのみ。そのグループ内のラジオボタンを選択すると、同じグループ内の現在選択されているラジオボタンの選択が自動的に解除されます。フォームが送信されると、チェックされた1つのラジオボタンが名前とともに送信されます。

一連の同じボタンにタブで移動する場合-ラジオボタンの名前付きグループ。1つがチェックされている場合、そのボタンはフォーカスを受け取ります。ソース順にグループ化されていない場合、グループの1つがチェックされていると、グループ内の最初のグループが検出されたときにグループへのタブ移動が開始され、チェックされていないものはすべてスキップされます。つまり、1つがチェックされている場合、タブを押すと、グループ内のチェックされていないラジオボタンがスキップされます。何もチェックされていない場合、同じ名前グループの最初のボタンに到達すると、ラジオボタングループがフォーカスを受け取ります。

グループ内のラジオボタンの1つにフォーカスがあると、矢印キーを使用してすべてをナビゲートします。ラジオボタンがソース順にグループ化されていない場合でも、同じ名前のラジオボタン。

HTMLFormElement.elements

入力要素にnameの場合、その名前は所有するフォーム要素のHTMLFormElement.elementsプロパティのプロパティになります。nameguestに設定され、namehat-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属性がサポートされていますtextsearchurltelemaildatemonthweektimedatetime-localnumber、およびpassword入力タイプ。

詳細については、HTML属性readonlyを参照してください。

requiredはブール属性であり、存在する場合、所有するフォームを送信する前に、ユーザーが入力の値を指定する必要があることを示します。 required属性は、textsearch、、telemaildatemonthweektimedatetime-localnumberpasswordcheckboxradio、およびfile入力。

詳細については、クライアント側の検証とHTML属性requiredを参照してください。

sizeemailpasswordtel、およびtextinputタイプのみ。表示される入力の量を指定します。基本的に、CSSwidthプロパティを設定するのと同じ結果をいくつかの特殊性で作成します。値の実際の単位は、入力タイプによって異なります。passwordおよびtextの場合、これは文字数(またはem単位)であり、デフォルト値は20で、その他の場合はpixelです。 CSSの幅はサイズ属性よりも優先されます。src

image入力ボタンにのみ有効です。srcは文字列を指定しますグラフィカルな送信ボタンを表すために表示する画像ファイルのURL。画像入力タイプを参照してください。

step

number、日付などの数値入力タイプに有効です/ time入力タイプ、およびrangestep属性は、値が準拠する必要のある粒度を指定する数値です。

明示的に含まれていない場合:

  • stepのデフォルトはnumberrange
  • 日付/時刻の入力タイプの場合、stepは秒で表され、デフォルトのステップは60秒です。 。ステップスケール係数は1000です(他のアルゴリズムで使用されるように、秒をミリ秒に変換します)。

値は正の数(整数または浮動小数点数)または特別な値

は、ステッピングが暗黙指定されておらず、任意の値が許可されていることを意味します(minmax)。

anyが明示的に設定されていない場合、number、日付/時刻入力タイプ、および

入力タイプは、ステップの基準と同じです—min値とステップ値の増分(値(指定されている場合)。

たとえば、<input type="number" min="10" step="2">がある場合は、任意の偶数の整数10以上が有効です。 <input type="number">を省略した場合、任意の整数は有効ですが、iv id = “817c131ab3″のため、float(4.2など)は無効です。 > のデフォルトは1です。 4.2を有効にするには、stepany、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は、グラフィカルな送信ボタンを表すために表示する画像ファイルの幅です。画像入力タイプを参照してください。

Leave a Reply

コメントを残す

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です