定義と使い方
<input>タグのtype="search"は、1行の検索語入力フィールドを表します。
このフィールドは、基本的な1行テキストフィールドのタイプであるtype="text"と非常によく似ていますが、検索語を入力するためのフィールドであることを明示的に示す点が異なります。
動的な仮想キーパッドを備えた一部のデバイス(例えば、モバイルデバイス)では、Enterキーに検索アイコンが表示されます。
ブラウザによっては、フィールドをクリアするために使用できる削除アイコンが表示される場合があります。
基本例
<search>
<form method="get" action="/search">
<label for="user-search">サイト内検索</label>
<input
type="search"
id="user-search"
name="query">
<button type="submit">検索</button>
</form>
</search>
関連する属性の使用
<input type="search">に関連する属性について説明します。
placeholder属性
placeholder属性は、値が設定されていない場合にテキスト入力コントロールに表示されるテキストを指定します。これを「プレースホルダーテキスト」と呼びます。この値は、コントロールに入力するデータの種類について、ユーザーに簡単なヒントを提供するものである必要があります。ユーザーがテキストの入力を開始すると、プレースホルダーテキストはテキスト入力フィールドから消えます。
<search>
<form method="get" action="/search">
<label for="user-search">サイト内検索</label>
<input
type="search"
id="user-search"
name="query"
placeholder="検索語を入力してください。">
<button type="submit">検索</button>
</form>
</search>
プレースホルダーテキストのスタイルについては、CSSでplaceholderスタイル適用方法を参照してください。
value属性
value属性は、初期値を設定します。
この値は、ページの読み込み時に要素に表示される検索語を指定します。
<input type="search" value="search keyword">
disabled属性
該当する要素を無効にするには、disabled属性を使用します。無効化された要素は、入力や値の変更を試みても、その機能が無効になっているため動作しません。また、フォームの送信時に値は送信されません。
この属性はブール属性(Boolean attribute)です。値を別途記述せず、属性名のみを記述します。
<input type="search" value="search keyword" disabled>
ただし、value属性を直接設定できるJavaScriptを使用すれば、引き続き該当するコントロールの値を変更できます。
readonly属性
readonly属性は、コントロールを変更または編集できないようにします。
この属性はブール属性(Boolean attribute)です。値を別途記述せず、属性名のみを記述します。
主にvalue属性と組み合わせて使用し、入力済みまたは保存済みのコントロールの値をユーザーに表示しつつ、編集できないようにします。フォームの送信時には、該当する値が送信されます。
<input type="search" value="search keyword" readonly>
ただし、value属性を直接設定できるJavaScriptを使用すれば、引き続き該当するコントロールの値を変更できます。
maxlength属性
maxlength属性は、ユーザーが入力できる最大文字数(Maximum length)を制限します。該当する要素にmaxlength属性を指定すると、ユーザーが許可された文字数を超えて入力するのを防ぐことができます。
- 属性値は、負の値ではない
0以上の整数である必要があります。 - 不正な値が指定された場合、最大文字数の制限は適用されません。
- 最大文字数は、標準的な文字単位(バイトではなくUTF-16コード単位)で計算されるため、英字、数字、日本語など、言語に関係なく同じように適用されます。ただし、一部の絵文字(例:😀)はUTF-16で2つのコード単位として表現されるため、最大文字数と一致しない場合があります。
覚えておいてください!
該当する要素に有効なminlength属性が設定されている場合、maxlength属性の値は、必ずその値より大きいか、等しくなければなりません。
<!-- maxlength="10"で最大10文字に制限 -->
<input type="search" maxlength="10" placeholder="最大10文字まで">
minlength属性
minlength属性は、ユーザーが入力する必要がある最小文字数(Minimum length)を指定します。該当する要素にminlength属性が指定されている場合、ユーザーは指定された最小文字数以上を入力する必要があります。
覚えておいてください!minlength属性は、入力すべき最小文字数のみをチェックします。ユーザーが該当する要素に何も入力しなかった場合、空の値は許容されます。空の値も許容しない場合は、required属性も併せて使用してください。
補足説明required属性は、フォームの送信時にユーザーがあらかじめ必ず値を入力する必要がある必須(required)のコントロール要素であることを示します。
- 属性値は、負の値ではない
0以上の整数である必要があります。 - 不正な値が指定された場合、入力すべき最小文字数の指定は適用されません。
- 最小文字数は、標準的な文字単位(バイトではなくUTF-16コード単位)で計算されるため、英字、数字、日本語など、言語に関係なく同じように適用されます。ただし、一部の絵文字(例:😀)はUTF-16で2つのコード単位として表現されるため、最小文字数と一致しない場合があります。
覚えておいてください!
該当する要素に有効なmaxlength属性が設定されている場合、minlength属性の値は、必ずその値より小さいか、等しくなければなりません。
<form>
<label for="search">検索語</label>
<!-- minlength="2"で最小2文字の入力を要求 -->
<input type="search" id="search" minlength="2" placeholder="2文字以上入力してください..." required>
<button type="submit">送信</button>
</form>
- エラーの確認:入力フィールドに何も入力しないか、1文字だけ入力してから、[送信]ボタンをクリックしてください。ブラウザに最小入力条件(2文字)を満たしていないことを示すエラーメッセージが表示されることを確認します。
- 送信成功の確認:フィールドに2文字以上入力してから、再度[送信]ボタンをクリックすると、エラーが発生せずにフォームが送信されることを確認します。
required属性
required属性は、フォームの送信時にユーザーがあらかじめ必ず値を入力する必要がある必須(required)のコントロール要素であることを示します。
この属性はブール属性(Boolean attribute)です。値を別途記述せず、属性名のみを記述します。
<form>
<fieldset>
<legend>検索語は必須</legend>
<p>
<label for="usersearch">検索語(*必須)</label>
<input id="usersearch" type="search" required> <!-- 必須入力フィールドとして指定 -->
</p>
<p>
<button type="submit">検索</button>
</p>
</fieldset>
</form>
- エラーの確認:検索語(*必須)フィールドに何も入力せずに、[検索]ボタンをクリックしてください。ブラウザに必須入力に関するエラーメッセージが表示されることを確認します。
- 送信成功の確認:検索語(*必須)フィールドに入力してから、再度[検索]ボタンをクリックすると、エラーが発生せずにフォームが送信されることを確認します。
pattern属性
pattern属性は、入力値を検証する際に使用する正規表現(regular expression)を指定します。
<input type="search" pattern="正規表現(regular expression)を指定">
name属性
name属性は、該当する要素の名前を表します。
name属性が指定されている場合、その値はフォームの送信時に送信されるデータの名前として使用されます。JavaScriptでも、name 属性の値は、該当する要素のform.elementsAPIで名前として使用されます。
size属性
size属性は、該当する要素の幅を文字数で指定します。
size属性で指定する値は、入力フィールドの幅を文字数を基準として視覚的に指定します。そのため、設定された文字サイズ(font-size)によって、実際に表示される幅が異なる場合があります。
size属性の値には、0より大きい整数を指定します。size属性が指定されていない場合、または無効な値が設定されている場合、ほとんどのブラウザではデフォルト値として20が使用されます。
size属性は入力フィールドの視覚的な幅のみを設定するものであり、フォームの送信時に入力文字数の制限に関する検証には影響しません。
<p>
<label>
size属性なし
<input type="search">
</label>
</p>
<p>
<label>
短い入力欄
<input type="search" size="5">
</label>
</p>
<p>
<label>
長い入力欄
<input type="search" size="50">
</label>
</p>
size属性が指定された要素にCSSで幅を指定した場合、CSSの指定が優先的に適用されます。
list属性
list属性は、該当する<input type="search">にあらかじめ定義されたオプションのリストを提供する<datalist>タグの id属性の値を指定します。
ユーザーは、このあらかじめ定義されたオプションのリストから選択することも、別の値を入力することもできます。ユーザーがコントロールをクリックまたはダブルクリックすると、該当する候補値がドロップダウンメニューに表示されます。例えば、Chromeブラウザでは、あらかじめ定義された値があることを示す矢印(▼)もコントロールの右側に表示されます。
<label for="user-search">検索</label>
<input type="search" list="keywords" id="user-search">
<!-- ドロップダウンメニューに表示 -->
<datalist id="keywords">
<option value="会社沿革"></option>
<option value="アクセス"></option>
<option value="連絡先情報"></option>
</datalist>
アクセシビリティに関する考慮事項
検索フォームにおいて、アクセシビリティは非常に重要です。検索フォームの目的は、一般的に、その配置によって視覚的に確認できるユーザーには明らかであるため、検索フィールドにラベル(名前札)を付けないことが一般的な設計慣行のように思えるかもしれません。
しかし、これはウェブアクセシビリティの観点から、スクリーンリーダーを使用するユーザーに混乱を与える可能性があります。スクリーンリーダーを使用するユーザーは、何を検索するための入力フィールドなのかを音声で把握できないためです。特に、placeholder属性をそのコントロールのラベル(名前札)の代わりに使用する場合が該当します。
ただし、placeholder属性は、そのコントロールのラベル(名前札)の代わりにはなりません。
placeholderを<label>の代わりに使用することはできません。
<form method="get" action="/search">
<input type="search" name="query" placeholder="検索語を入力してください。">
<button type="submit">検索</button>
</form>
詳しくは、<input>タグのアクセシビリティに関する考慮事項を参照してください。
ブラウザーの互換性
| 属性 |
デスクトップ Chrome
|
デスクトップ Edge
|
デスクトップ Firefox
|
Safari
|
|---|---|---|---|---|
<input type="search">
|
5 | 12 | 4 | 10.6 |
list
|
22 | 12 | 4 | 12.1 |
仕様書
| 仕様書 | |
|---|---|
<input type="search">
|
HTML Standard #text-(type=text)-state-and-search-state-(type=search) |