HTMLInputElement: list プロパティ

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

関連情報