HTMLInputElement: list プロパティ
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 を返す
仕様書
Specification |
---|
HTML Standard # dom-input-list-dev |
ブラウザーの互換性
BCD tables only load in the browser