CKTIS / HTML
list — een invoerveld koppelen aan suggesties
Het attribuut `list` koppelt een `input` aan een `datalist` met voorgestelde waarden. Het beperkt de ingevoerde waarde niet tot die suggesties.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<input type="text" list="choices">
<datalist id="choices">
<option value="HTML"></option>
</datalist>list verwijst via de id naar een datalist in dezelfde boom. De waarde is een identificatie, geen CSS-selector: gebruik topics, niet #topics. Het attribuut geldt alleen voor geschikte input-typen, zoals text; het geldt niet voor password.
De option-elementen in een datalist leveren suggesties. list dwingt niet af dat de ingevoerde waarde een van die suggesties is: andere validatiebeperkingen blijven gelden. Gebruik select als een keuze uit een gesloten lijst vereist is.
De browser bepaalt hoe suggesties worden weergegeven en gefilterd. Als er geen overeenkomend element is, is er geen suggestiebron. Het eerste element met de opgegeven id is bepalend; als dat geen datalist is, wordt er geen koppeling gemaakt. Vermijd dubbele ID's.
In het voorbeeld geeft de DOM-eigenschap input.list de gekoppelde datalist terug. De waarde JavaScript, die niet in de lijst staat, blijft geldig. Daarom is de laatste uitvoerregel true.
Voorbeelden
<!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>Resultaat
topics JavaScript true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.