CKTIS / HTML
list — prepojenie vstupného poľa s návrhmi
Atribút `list` prepája `input` s prvkom `datalist`, ktorý obsahuje navrhované hodnoty. Neobmedzuje zadanú hodnotu na tieto návrhy.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<input type="text" list="choices">
<datalist id="choices">
<option value="HTML"></option>
</datalist>list odkazuje na datalist pomocou jeho id v tom istom strome. Jeho hodnota je identifikátor, nie CSS selektor: použite topics, nie #topics. Atribút sa vzťahuje iba na vhodné typy input, napríklad text; nevzťahuje sa na password.
Prvky option v datalist poskytujú návrhy. list nevynucuje, aby zadaná hodnota bola jedným z nich: ostatné validačné obmedzenia naďalej platia. Ak je potrebné vybrať položku z uzavretého zoznamu, použite select.
Prehliadač určuje zobrazenie a filtrovanie návrhov. Ak neexistuje zodpovedajúci prvok, nie je k dispozícii žiadny zdroj návrhov. Rozhodujúci je prvý prvok so zadaným id; ak nejde o datalist, prepojenie sa nevytvorí. Vyhnite sa duplicitným ID.
V príklade vracia vlastnosť DOM input.list prepojený datalist. Hodnota JavaScript, ktorá nie je v zozname, zostáva platná, takže posledný riadok výstupu je true.
Príklady
<!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>Výsledok
topics JavaScript true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.