WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

list — ein Eingabefeld mit Vorschlägen verknüpfen

Das Attribut `list` verknüpft ein `input` mit einem `datalist`, das Vorschlagswerte enthält. Es beschränkt den eingegebenen Wert nicht auf diese Vorschläge.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<input type="text" list="choices">
<datalist id="choices">
  <option value="HTML"></option>
</datalist>

list verweist über dessen id auf ein datalist im selben Baum. Der Wert ist eine Kennung, kein CSS-Selektor: Verwende topics, nicht #topics. Das Attribut gilt nur für geeignete input-Typen wie text; für password gilt es nicht.

Die option-Elemente in einem datalist liefern Vorschläge. list erzwingt nicht, dass der eingegebene Wert einem Vorschlag entspricht: Andere Validierungsbedingungen gelten weiterhin. Wenn eine Auswahl aus einer abgeschlossenen Liste erforderlich ist, verwende select.

Der Browser bestimmt die Darstellung und Filterung der Vorschläge. Gibt es kein passendes Element, steht keine Vorschlagsquelle zur Verfügung. Entscheidend ist das erste Element mit der angegebenen id; ist es kein datalist, wird keine Verknüpfung hergestellt. Vermeide doppelte IDs.

Im Beispiel gibt die DOM-Eigenschaft input.list das verknüpfte datalist zurück. Der nicht in der Liste enthaltene Wert JavaScript bleibt gültig, daher lautet die letzte Ausgabezeile true.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>list example</title>
<label for="topic">Topic</label>
<input id="topic" type="text" list="topics">
<datalist id="topics">
  <option value="HTML"></option>
  <option value="CSS"></option>
</datalist>
<pre id="result"></pre>
<script>
  const input = document.getElementById('topic');
  input.value = 'JavaScript';
  document.getElementById('result').textContent =
    `${input.list.id}\n${input.value}\n${input.checkValidity()}`;
</script>
</html>

Ergebnis

topics
JavaScript
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen