CKTIS / HTML
HTML-element: datalist
Het suggestielijstelement geeft een formulierbesturing een niet-bindende reeks waarden en laat een andere geldige waarde toe.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<input list="cities"><datalist id="cities"><option value="Oslo"></datalist>datalist koppelt aan een compatibele input via list dat gelijk is aan zijn id; HTMLInputElement.list geeft het opgeloste element of null.
Suggesties komen uit afstammelingen option: value is de in te voegen waarde, label kan beschrijven en lege of disabled opties zijn geen suggesties.
datalist is geen select en verplicht geen keuze. Beperkingen zoals required en pattern valideren de eindwaarde onafhankelijk, terwijl interface en filtering per browser verschillen.
Het voorbeeld telt kandidaten via options, voert een niet-vermelde waarde in en roept checkValidity() aan om te bevestigen dat value niet tot suggesties is beperkt.
Voorbeelden
<!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>
Resultaat
linked=true; options=4; suggestions=2; unlisted=Reykjavík; valid=true
Het resultaat bevestigt de koppeling, twee bruikbare suggesties en een geldige niet-vermelde waarde; het beoordeelt het native menu niet.