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 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 を返す

仕様書

Specification

HTML
# dom-input-list-dev

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025年4月12日 by MDN contributors.

View this page on GitHub • Report a problem with this content

HTMLInputElement: list プロパティ

In this article

値

例

仕様書

ブラウザーの互換性

関連情報

Help improve MDN