HTMLInputElement: list プロパティ
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2019年3月以降、すべてのブラウザーで利用可能です。
list は HTMLInputElement インターフェイスの読み取り専用プロパティで、この要素の list 属性が指し示す HTMLDataListElement を返します。list 属性が定義されていない場合、または list 属性の値が同じツリー内のどの <datalist> にも関連付けられていない場合は、null が返されます。
メモ:
これは読み取り専用のプロパティです。 <datalist> を要素に関連付けるには、setAttribute() を使用して list 属性の値を設定します。
値
HTMLDataListElement または null です。
例
次の HTML があったとします。
html
<label for="planet">出身の惑星は？</label>
<input id="planet" type="text" list="superhero" />
<datalist id="superhero">
<option value="Azarath" />
<option value="Krypton" />
<option value="Tamaran" />
</datalist>
この <input> に関連付けられた <datalist> を受け取るには次のようにします。
js
const inputElement = document.querySelector("#planet");
console.log(inputElement.list); // superhero の HTMLDatalistElement を返す
仕様書
| 仕様書 |
|---|
| HTML # dom-input-list-dev |