デモ例
<input>タグは、子コンテンツを持つことができない空要素(Void element)です。つまり、終了タグ(</input>)はありません。
<form action="submit_url" method="get" class="form-example">
<div class="form-example">
<label for="user-name">名前</label>
<input type="text" id="user-name" name="user-name" required>
</div>
<div class="form-example">
<label for="user-email">メールアドレス</label>
<input type="email" id="user-email" name="user-email" required>
</div>
<input type="submit">
</form>
コードの補足説明<form>タグは、データを送信するためのWebフォーム(入力フォーム)の領域を表します。
この領域には、Webフォームに関連するコントロール要素が含まれ、これらの要素のデータを処理したり送信したりするための定義に使用されます。
type属性
<input>タグは、type属性の値に応じてさまざまな種類のコントロールを提供します。
type属性が指定されていない場合、デフォルト値はtextです。
主要なブラウザの一部でサポートされていないtype属性の値は含めていません。
type |
説明 | 基本例 |
|---|---|---|
<input type="button"> |
デフォルトの動作を持たないボタンです。 JavaScriptと組み合わせることで、さまざまな動作を実行できます。 |
|
<input type="checkbox"> |
チェックボックスです。 1つの項目をチェックしたり、チェックを外したりできます。一般的には四角形ですが、角が丸くなっている場合もあります。 |
|
<input type="color"> |
ユーザーが色を選択または入力できる、カラーピッカー形式の入力フィールドを表します。 ブラウザで有効にすると、カラーピッカーが開きます。 |
|
<input type="date"> |
日付入力コントロールです。 ブラウザで有効にすると、年、月、日を選択するための日付ピッカーや数値ホイールが開きます。 |
|
<input type="datetime-local"> |
ユーザーが日付と時刻をまとめて簡単に入力できるように、日付と時刻の選択インターフェースを提供する入力フィールドです。 | |
<input type="email"> |
メールアドレスの入力フィールドです。 テキスト入力フィールドのように見えますが、動的な仮想キーパッドを備えた一部のデバイス(モバイルデバイスなど)では、@や.など、メールアドレスの入力に適したキーパッドが表示されます。 |
|
<input type="file"> |
ユーザーがデバイス上のファイルを選択してアップロードできる入力フィールドです。 | |
<input type="hidden"> |
隠し入力フィールドです。ユーザーには表示されませんが、フォームの送信時にデータを一緒に送信できます。 | |
<input type="image"> |
テキストではなく画像として表示されるフォーム(<form>)の送信ボタンです。このボタンをクリックすると、その要素を含むフォーム内の送信可能なすべてのコントロールの値が送信されます。 |
|
<input type="number"> |
数値入力フィールドです。 スピナーを表示し、数値のみを入力できるように入力値を検証します。動的なキーパッドを備えた一部のデバイス(モバイルデバイスなど)では、数字キーパッドが表示されます。 |
|
<input type="password"> |
パスワード入力フィールドです。 入力した値が隠される1行のテキスト入力コントロールです。ブラウザは、入力された機密情報が画面上で見えないように、テキスト文字を点(「•」)などの記号に置き換えて読み取れないようにします。 |
|
<input type="radio"> |
ラジオボタンです。 一般的には小さな円として表示され、選択すると内側が塗りつぶされたり、強調表示されたりします。 |
|
<input type="range"> |
範囲スライダーです。設定された数値範囲内で値を選択できます。 | |
<input type="reset"> |
フォーム(<form>)のリセットボタンです。このボタンをクリックすると、その要素を含むフォーム内のすべてのコントロールの値が初期化されます。 |
|
<input type="search"> |
検索語の入力フィールドです。 1行のテキスト入力コントロールです。動的な仮想キーパッドを備えた一部のデバイス(モバイルデバイスなど)では、検索アイコンが表示されます。ブラウザによっては、入力フィールドをクリアするための削除アイコンが表示される場合もあります。 |
|
<input type="submit"> |
フォーム(<form>)の送信ボタンです。このボタンをクリックすると、その要素を含むフォーム内の送信可能なすべてのコントロールの値が送信されます。 |
|
<input type="tel"> |
電話番号の入力フィールドです。 1行のテキスト入力コントロールですが、電話番号の形式は検証しません。 |
|
<input type="text"> |
type属性のデフォルト値で、通常のテキスト入力フィールドです。1行のテキスト入力コントロールです。 |
|
<input type="time"> |
時刻を簡単に入力できるように、時刻選択インターフェースを提供する入力コントロールです。 | |
<input type="url"> |
URLの入力フィールドです。 テキスト入力フィールドのように見えますが、動的な仮想キーパッドを備えた一部のデバイス(モバイルデバイスなど)では、/や.など、URLの入力を補助するキーや、www.や.comなど、ドメイン名で一般的に使用される文字列をすばやく入力するためのキーを備えたURL入力に適したキーパッドが表示されます。 |
覚えておいてください!
ブラウザやオペレーティングシステムによって、type属性の値に応じたコントロールのインターフェースやスタイルが多少異なる場合があります。
ブラウザーの互換性
| 属性値 |
デスクトップ Chrome
|
デスクトップ Edge
|
デスクトップ Firefox
|
Safari
|
|---|---|---|---|---|
type="button"
|
1 | 12 | 1 | 1 |
type="checkbox"
|
1 | 12 | 1 | 1 |
type="color"
|
20 | 14 | 29 | 12.1 |
type="date"
|
20 | 12 | 53 | 14.1 |
type="datetime-local"
|
20 | 12 | 93 | 14.1 |
type="email"
|
5 | 12 | 1 | 5 |
type="file"
|
1 | 12 | 1 | 1 |
type="hidden"
|
1 | 12 | 1 | 1 |
type="image"
|
1 | 12 | 1 | 1 |
type="number"
|
7 | 12 | 29 | 5.1 |
type="password"
|
1 | 12 | 1 | 1 |
type="radio"
|
1 | 12 | 1 | 1 |
type="range"
|
4 | 12 | 23 | 3.1 |
type="reset"
|
1 | 12 | 1 | 1 |
type="search"
|
5 | 12 | 4 | 10.6 |
type="submit"
|
1 | 12 | 1 | 1 |
type="tel"
|
3 | 12 | 1 | 4 |
type="text"
|
1 | 12 | 1 | 1 |
type="time"
|
20 | 12 | 57 | 14.1 |
type="url"
|
1 | 12 | 1 | 1 |
さまざまな属性
<input>タグは、さまざまな属性を持ち、非常に便利です。
その中でも最も重要なのはtype属性で、先ほどさまざまな例を通して説明しました。すべての<input>タグは共通の基本属性を持っていますが、実際には特定のtype属性でのみ影響する属性も多くあります。また、type属性の値によって動作が異なる属性もあります。
<input>タグでは、すべてのグローバル属性を使用できます。
ここでは、<input>タグの主な属性を簡単にまとめた表を示し、各属性について詳しく説明するとともに、どの入力タイプに関連するかを解説します。
| 属性 | 関連するtype属性の値 |
説明 |
|---|---|---|
accept |
file |
ファイルアップロードコントロールで許可するファイル形式を指定します。 |
alt |
image |
src属性に対する代替テキストです。src属性が指定されていない場合は、alt属性の値が表示されます。アクセシビリティのために必須の属性です。 |
autocapitalize |
text、search、tel |
この属性はグローバル属性です。 ユーザーが入力または編集するテキストを自動的に大文字に変換する方法を指定します。物理キーボードから入力する場合は影響せず、音声入力やモバイルデバイスの仮想キーボードなどにのみ適用されます。 この属性は列挙型属性で、指定できる値は次のとおりです。
|
autocomplete |
checkbox、radioおよびボタンに関連する値を除くすべての値 |
コントロールでオートコンプリート機能を使用するかどうかを指定します。
|
checked |
checkbox、radio |
チェックボックスがデフォルトでチェックされているかどうかを示す属性です。ページの初回読み込み時にチェックボックスをチェック済みの状態にするには、checked属性を使用します。ただし、ページの読み込み後にユーザーがチェックボックスをチェックしたり、チェックを外したりしても、checked属性は変化しません。この属性はブール属性(Boolean attribute)です。値を別途記述せず、属性名のみを記述します。 |
disabled |
すべての値 | コントロールが無効になっていることを示します。 この属性はブール属性(Boolean attribute)です。値を別途記述せず、属性名のみを記述します。 |
form |
すべての値 | コントロールをフォーム要素に関連付けます(associated with)。 |
list |
text、search、url、tel、email、date、month、week、time、datetime-local、number、range、color、 |
あらかじめ定義された選択肢のリストを提供する<datalist>タグのid属性の値を指定します。 |
max |
date、time、datetime-local、number、range |
コントロールの最大値を指定します。 |
maxlength |
text、search、url、tel、email、password |
ユーザーが入力できる最大文字数(Maximum length)を制限します。 |
min |
date、time、datetime-local、number、range |
コントロールの最小値を指定します。 |
minlength |
text、search、url、tel、email、password |
ユーザーが入力する必要がある最小文字数(Minimum length)を指定します。 |
multiple |
file、email
| 複数の値を同時に選択または入力できるようにします。 この属性はブール属性(Boolean attribute)です。値を別途記述せず、属性名のみを記述します。 |
name |
すべての値 | コントロールの名前を示します。 |
pattern |
text、search、url、tel、email、password |
コントロールのテキスト値を検証する際に使用する正規表現(regular expression)を指定します。 |
placeholder |
text、search、url、tel、email、password、number |
値が設定されていない場合にコントロールに表示されるテキストを指定します。この値は、コントロールに入力するデータの種類について、ユーザーに簡単なヒントを提供するものである必要があります。 |
readonly |
テキスト関連の値(text、password、search、url、tel、email、number、date、time、datetime-local、month、week) |
ユーザーがその要素を編集できない読み取り専用状態になります。 この属性はブール属性(Boolean attribute)です。値を別途記述せず、属性名のみを記述します。 |
required |
hidden、range、colorおよびボタンに関連する値を除くすべての値 |
フォームを送信する前に、ユーザーがコントロールに値を入力する必要があることを示します。 この属性はブール属性(Boolean attribute)です。値を別途記述せず、属性名のみを記述します。 |
size |
text、search、url、tel、email、password |
1行のテキスト入力フィールドの幅を、文字数を基準に指定します。 この値は、 0より大きい正の整数である必要があります。 |
src |
image |
画像のパスを指定します。 |
step |
date、time、datetime-local、number、range |
コントロールの数値を増減する間隔を指定します。 |
value |
fileとimageを除くすべての値 |
そのコントロール要素が持つ値です。 この要素の type属性で示される種類ごとに、値の意味が定義されています。 |
基本例
上の表で説明した属性の簡単な基本例をいくつか示します。
checked
チェックボックスがデフォルトで選択されているかどうかを示す属性です。ページの初回読み込み時にチェックボックスを選択済みの状態にするには、checked属性を使用します。ただし、ページの読み込み後にユーザーがチェックボックスを選択したり、選択を解除したりしても、checked属性は変化しません。
この属性はブール属性(Boolean attribute)です。値を別途記述せず、属性名のみを記述します。
<input type="checkbox" checked>
<input type="radio" checked>
disabled
disabled属性は、コントロールが無効になっていることを示します。この属性はブール属性(Boolean attribute)です。値を別途記述せず、属性名のみを記述します。
<label for="user-id">ユーザーID</label>
<input type="text" id="user-id" disabled>
placeholder
placeholder属性は、値が設定されていない場合にテキスト入力コントロールに表示されるテキストを指定します。これを「プレースホルダーテキスト」と呼びます。
この値は、コントロールに入力するデータの種類について、ユーザーに簡単なヒントを提供するものである必要があります。ユーザーがテキストを入力し始めると、プレースホルダーテキストはテキスト入力フィールドから消えます。
<label for="user-company">会社名</label>
<input type="text" id="user-company" placeholder="(例)株式会社サンプル">
value, min, max, step
value属性は、そのコントロール要素が持つ値です。
この要素のtype属性で示される種類ごとに、値の意味が定義されています。
min属性は、コントロールの最小値を指定します。
max属性は、コントロールの最大値を指定します。
step属性は、コントロールの数値を増減する間隔を指定します。
<label for="user-number">数量を選択</label>
<input type="number" id="user-number" value="4" min="0" max="20
ブラウザーの互換性
最終更新日:
| 属性 |
デスクトップ Chrome
|
デスクトップ Edge
|
デスクトップ Firefox
|
Safari
|
|---|---|---|---|---|
accept
|
1 | 12 | 1 | 1 |
alt
|
1 | 12 | 1 | 1 |
autocapitalize
|
4 | 79 | 111 | いいえ |
autocomplete
|
14 | 79 | 4 | 6 |
checked
|
1 | 12 | 1 | 1 |
disabled
|
1 | 12 | 1 | 1 |
form
|
1 | 12 | 1 | 1 |
max
|
4 | 12 | 16 | 5 |
maxlength
|
1 | 12 | 1 | 1 |
min
|
4 | 12 | 16 | 5 |
minlength
|
40 | 17 | 51 | 10.1 |
name
|
1 | 12 | 1 | 1 |
pattern
|
4 | 12 | 4 | 5 |
placeholder
|
3 | 12 | 4 | 4 |
readonly
|
1 | 12 | 1 | 1 |
required
|
4 | 12 | 4 | 5 |
size
|
1 | 12 | 1 | 1 |
src
|
1 | 12 | 1 | 1 |
step
|
5 | 12 | 16 | 5 |
アクセシビリティに関する考慮事項
コントロール要素とは、
ユーザーがWebページと対話できるようにする要素を指します。<input>、<textarea>、<button>、<select>など、ユーザーがデータを入力、選択、送信するための操作を行える要素が該当します。
<input>、<textarea>、<select>タグなどのコントロール要素を使用する際は、<label>も併せて使用する必要があります。
これは、アクセシビリティを確保するための最低限の要件です。
<label>タグをコントロール要素に使用するメリット
<label>とコントロール要素の関連付け
<!--
# 関連付けるコントロール要素のid属性の値である"user-checking"を
# labelタグのfor属性の値として指定しました。
-->
<label for="user-checking">クリックしてください。</label>
<input type="checkbox" id="user-checking">
このように関連付けると、<label>のテキスト("クリックしてください。")をクリックすると、関連付けられたチェックボックスにフォーカスが移動します。
<label>のテキスト("クリックしてください。")をクリックすると、関連付けられたチェックボックスにフォーカスが移動します。
<label>
クリックしてください。
<input type="checkbox">
</label>
<label>のテキスト("クリックしてください。")をクリックすると、関連付けられたチェックボックスにフォーカスが移動します。
上記の2つの方法はいずれも、仕様書で有効な例として示されています。
技術的文法の要約
| 許可される親要素 | 記述コンテンツを受け入れるすべての要素 |
|---|---|
| 許可されるコンテンツ | なし。この要素は空要素(Void element)です。 |
暗黙的なrole属性の値 |
|
許可されるrole属性の値 |
|
仕様書
| 仕様書 | |
|---|---|
<input>
|
HTML Standard #the-input-element |
関連項目
- HTML <label>タグ:正しい理解と使い方
- HTML inputmode属性:仮想キーボードの入力モード指定
- HTML enterkeyhint属性:仮想キーボードのEnterキーの表示を指定
- HTML <input type="button">:正しい理解と使い方
- HTML <input type="checkbox">:チェックボックス
- HTML <input type="hidden">:正しい理解と使い方
- HTML <input type="number">:数字のみ入力
- HTML <input type="password">:正しい理解と使い方
- HTML <input type="radio">:ラジオボタン
- HTML <input type="reset">:正しい理解と使い方
- HTML <input type="search">:正しい理解と使い方
- HTML <input type="submit">:正しい理解と使い方
- HTML <input type="text">:正しい理解と使い方
- HTML <input type="url">:正しい理解と使い方
- HTML <textarea>タグ:正しい理解と使い方
- HTML <select>タグ:正しい理解と使い方
- HTML <fieldset>タグ:正しい理解と使い方
- HTML <legend>タグ:正しい理解と使い方
- HTML <button>タグ:ボタン要素
- CSS ::placeholder擬似要素セレクタ:placeholderスタイル適用方法