CKTIS / HTML
list — povezivanje polja za unos s prijedlozima
Atribut `list` povezuje `input` s elementom `datalist` koji sadrži predložene vrijednosti. Ne ograničava unesenu vrijednost na te prijedloge.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<input type="text" list="choices">
<datalist id="choices">
<option value="HTML"></option>
</datalist>list upućuje na datalist putem njegova id u istom stablu. Vrijednost je identifikator, a ne CSS selektor: upotrijebi topics, a ne #topics. Atribut se primjenjuje samo na odgovarajuće vrste input, primjerice text; ne primjenjuje se na password.
Elementi option u elementu datalist nude prijedloge. list ne zahtijeva da unesena vrijednost bude jedan od njih: ostala ograničenja provjere valjanosti i dalje vrijede. Ako je potreban odabir iz zatvorenog popisa, upotrijebi select.
Preglednik određuje prikaz i filtriranje prijedloga. Ako ne postoji odgovarajući element, nema izvora prijedloga. Važan je prvi element sa zadanim id; ako to nije datalist, veza se ne uspostavlja. Izbjegavaj duplicirane ID-jeve.
U primjeru svojstvo DOM input.list vraća povezani datalist. Vrijednost JavaScript, koja nije na popisu, ostaje valjana, pa je posljednji redak izlaza true.
Primjeri
<!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>Rezultat
topics JavaScript true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.