CKTIS / HTML
HTML-Element: datalist
Das Vorschlagslistenelement liefert einem Formularfeld eine unverbindliche Menge vorgeschlagener Werte und erlaubt weiterhin andere gültige Eingaben.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<input list="cities"><datalist id="cities"><option value="Oslo"></datalist>datalist verbindet sich mit einem kompatiblen input über list, dessen Wert seiner id entspricht; HTMLInputElement.list liefert das aufgelöste Element oder null.
Vorschläge stammen aus option-Nachfahren: value ist der einzusetzende Wert, label kann beschreiben, leere oder disabled Optionen sind keine Vorschläge.
datalist ist kein select und erzwingt keine Auswahl. Beschränkungen wie required und pattern prüfen den Endwert unabhängig; Oberfläche und Filterung variieren je Browser.
Das Beispiel zählt Kandidaten über options, trägt einen nicht gelisteten Wert ein und bestätigt mit checkValidity(), dass value nicht auf Vorschläge beschränkt ist.
Beispiele
<!doctype html>
<meta charset="utf-8">
<label>City <input id="city" name="city" list="cities" value="Oslo"></label>
<datalist id="cities">
<option value="Oslo"></option>
<option value="Tokyo"></option>
<option value=""></option>
<option value="Lima" disabled></option>
</datalist>
<output id="result"></output>
<script>
const city = document.querySelector("#city");
const source = document.querySelector("#cities");
const suggestions = [...source.options].filter(option => option.value && !option.disabled);
city.value = "Reykjavík";
document.querySelector("#result").textContent = `linked=${city.list === source}; options=${source.options.length}; suggestions=${suggestions.length}; unlisted=${city.value}; valid=${city.checkValidity()}`;
</script>
Ergebnis
linked=true; options=4; suggestions=2; unlisted=Reykjavík; valid=true
Das Ergebnis bestätigt Verbindung, zwei brauchbare Vorschläge und einen gültigen ungelisteten Wert; das Aussehen des nativen Popups wird nicht bewertet.