HTMLInputElement: list-Eigenschaft

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.

Die list schreibgeschützte Eigenschaft der HTMLInputElement Schnittstelle gibt das HTMLDataListElement zurück, auf das durch das list-Attribut des Elements verwiesen wird, oder null, wenn das list-Attribut nicht definiert ist oder der Wert des list-Attributs mit keinem <datalist> im gleichen Baum assoziiert ist.

Hinweis: Dies ist eine schreibgeschützte Eigenschaft. Um ein <datalist> mit einem Element zu verknüpfen, setzen Sie den Wert des list-Attributs mit setAttribute().

Wert

Ein HTMLDataListElement oder null.

Beispiel

Angenommen, Sie haben das folgende 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>

Sie können das mit dem <input> assoziierte <datalist>-Element abrufen:

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

Spezifikationen

Specification
HTML
# dom-input-list-dev

Browser-Kompatibilität

Siehe auch