HTMLInputElement: list 屬性

Baseline 已廣泛支援

此功能已成熟,並可在多種裝置和瀏覽器版本上執行。自 2019 年 3 月以來,它已在所有瀏覽器中可用。

HTMLInputElement 介面中只讀的 list 屬性會返回由該元素的 list 屬性指向的 HTMLDataListElement,如果 list 屬性未定義,或者 list 屬性的值未與同一樹中的任何 <datalist> 關聯,則返回 null

注意:這是一個只讀屬性。要將 <datalist> 與元素關聯,請使用 setAttribute() 設定 list 屬性的值。

一個 HTMLDataListElementnull

示例

給定以下 HTML

html
<label for="planet">Which planet are you from?</label>
<input id="planet" type="text" list="superhero" />
<datalist id="superhero">
  <option value="Azarath"></option>
  <option value="Krypton"></option>
  <option value="Tamaran"></option>
</datalist>

您可以檢索與 <input> 關聯的 <datalist> 元素

js
const inputElement = document.querySelector("#planet");
console.log(inputElement.list); // returns the superhero HTMLDatalistElement

規範

規範
HTML
# dom-input-list-dev

瀏覽器相容性

另見