このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
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 type="text" list="superhero" /><datalist> <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 |