<input list=データリストID>－HTML Living Standard リファレンス

トップページ > HTML Living Standard > <input> > list=データリストID

★HTML Living Standard リファレンス

<input list=データリストID> …… データリストを紐づける
Internet Explorer

<input list=データリストID>は、入力欄とデータリストを紐づける際に使用します。

input要素のlist属性は、そのinput要素がどのdatalist要素と関連しているのか識別するために使用されます。 input要素にlist属性が存在する場合、その値は同じツリー内のdatalist要素のIDと一致している必要があります。

datalist要素で定義したデータリストは、ユーザーエージェントがオートコンプリートなどでユーザーに入力提案する際に使用されます。

■属性

list属性: オートコンプリートオプションのリストを指定します。

■使用例

以下のサンプルは、JavaScript関数のタイプをオートコンプリートで入力きるように、入力候補となるデータリストを用意しています。 input要素のlist属性の値と datalist要素のid属性の値を一致させることで、入力欄とデータリストが紐づけられています。

HTMLソース

<form method="post" action="step2.cgi">
 <p>
  <label>関数タイプ：<input type="text" name="ftype" list="function-types"></label>
  <datalist id="function-types">
   <option>function</option>
   <option>async function</option>
   <option>generator function</option>
   <option>arrow function</option>
   <option>async arrow function</option>
   <option>async generator function</option>
  </datalist>
 </p>
 <p><input type="submit" value="次へ"></p>
</form>

↓↓↓

ブラウザ上の表示

■使用例

以下のサンプルは、データテキストをoption要素のvalue属性の値として配置しており、option要素の内容としてインラインには配置していません。このような配置にすると、datalist要素をサポートしていない旧いブラウザでは、オートコンプリートのリストは表示されないようです。（筆者は旧いブラウザでの動作確認はしていませんが、仕様ではそのように解説されています。）

HTMLソース

<p>
 <label>
  品種を入力:
  <input type="text" name="breed" list="breeds">
  <datalist id="breeds">
   <option value="アビシニアン">
   <option value="マンチカン">
   <option value="ラグドール">
  </datalist>
 </label>
</p>

↓↓↓

ブラウザ上の表示

品種を入力:

■使用例

以下のサンプルでは、URL入力欄にdatalist要素で定義したオートコンプリートのリストが表示されます。ユーザーエージェントによっては、ユーザーの履歴にある他のURLが表示される可能性もあります。

HTMLソース

<label>ホームページ: <input name=hp type=url list=hpurls></label>
<datalist id=hpurls>
 <option value="https://www.google.com/" label="Google">
 <option value="https://www.yahoo.co.jp/" label="Yahoo! JAPAN">
</datalist>

↓↓↓

ブラウザ上の表示

ホームページ:

input要素の終了タグについて

HTMLの仕様では、input要素には終了タグ</input>はありません。

■関連項目

<form> …… フォームを表す
<label> …… フォーム入力欄のキャプションを表す
<input> …… フォーム入力欄を表す

<input type=hidden> …… 非表示データを表す
<input type=text> …… 1行プレーンテキストの入力欄を表す
<input type=search> …… 検索用テキストの入力欄を表す
<input type=tel> …… 電話番号の入力欄を表す
<input type=url> …… URLの入力欄を表す
<input type=email> …… 電子メールアドレスの入力欄を表す
<input type=password> …… パスワードの入力欄を表す
<input type=date> …… 日付の入力欄を表す
<input type=month> …… 月の入力欄を表す
<input type=week> …… 週の入力欄を表す
<input type=time> …… 時刻の入力欄を表す
<input type=datetime-local> …… ローカル日時の入力欄を表す
<input type=number> …… 数値の入力欄を表す
<input type=range> …… レンジ入力欄を表す
<input type=color> …… 色の入力欄を表す
<input type=checkbox> …… チェックボックスの入力欄を表す
<input type=radio> …… ラジオボタンの入力欄を表す
<input type=file> …… 選択ファイルを表す
<input type=submit> …… フォーム送信ボタンを表す
<input type=image> …… 画像ボタンを表す
<input type=reset> …… リセットボタンを表す
<input type=button> …… 汎用ボタンを表す
<input maxlength=文字数> …… 入力を許容する最大文字数を指定する
<input minlength=文字数> …… 入力を許容する最小文字数を指定する
<input size=サイズ> …… 入力欄のサイズを指定する
<input readonly> …… 読み取り専用にする
<input required> …… 入力必須にする
<input multiple> …… 複数選択可にする
<input pattern=入力パターン> …… 入力を許容するパターンを指定する
<input min=数値> …… 入力を許容する最小値を指定する
<input max=数値> …… 入力を許容する最大値を指定する
<input step=ステップ値> …… 入力のステップ値を指定する
<input list=データリストID> …… データリストを紐づける
<input placeholder=入力ヒント> …… 入力の際のヒントを表す

<button> …… ボタンを表す
<select> …… セレクトボックスを表す
<datalist> …… 選択肢のデータリストを表す
<optgroup> …… 選択肢グループを表す
<option> …… 選択肢を表す
<textarea> …… 複数行プレーンテキストの入力欄を表す
<output> …… 実行結果の出力を表す
<progress> …… タスクの進行状況を表す
<meter> …… 既知の範囲内の測定値を表す
<fieldset> …… フォームグループを表す
<legend> …… フォームグループのキャプションを表す

★HTML Living Standard リファレンス

■属性

■使用例

HTMLソース

ブラウザ上の表示

■使用例

HTMLソース

ブラウザ上の表示

■使用例

HTMLソース

ブラウザ上の表示

input要素の終了タグについて

■関連項目

Sponsors