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.

We'd love to hear more about your role and the company you work for

Please help us by answering a few questions.

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> を受け取るには次のようにします。

const inputElement = document.querySelector("#planet");
console.log(inputElement.list); // superhero の HTMLDatalistElement を返す

仕様書

Specification
HTML # dom-input-list-dev

HTMLInputElement: list プロパティ

値

例

仕様書

ブラウザーの互換性

関連情報