HTMLInputElement: list-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2019 browserübergreifend verfügbar.
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:
<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:
const inputElement = document.querySelector("#planet");
console.log(inputElement.list); // returns the superhero HTMLDatalistElement
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-input-list-dev |