CKTIS / HTML
list — propojení vstupního pole s návrhy
Atribut `list` propojuje `input` s prvkem `datalist`, který obsahuje navrhované hodnoty. Neomezuje zadanou hodnotu na tyto návrhy.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<input type="text" list="choices">
<datalist id="choices">
<option value="HTML"></option>
</datalist>list odkazuje na datalist pomocí jeho id ve stejném stromu. Jeho hodnota je identifikátor, nikoli CSS selektor: použijte topics, ne #topics. Atribut se vztahuje pouze na vhodné typy input, například text; nevztahuje se na password.
Prvky option v datalist poskytují návrhy. list nevynucuje, aby zadaná hodnota byla jedním z nich: ostatní validační omezení platí dál. Pokud je nutné vybírat z uzavřeného seznamu, použijte select.
Prohlížeč určuje zobrazení a filtrování návrhů. Pokud neexistuje odpovídající prvek, není k dispozici žádný zdroj návrhů. Rozhodující je první prvek se zadaným id; pokud nejde o datalist, propojení se nevytvoří. Vyhněte se duplicitním ID.
V příkladu vrací vlastnost DOM input.list propojený datalist. Hodnota JavaScript, která v seznamu není, zůstává platná, takže poslední řádek výstupu je true.
Pří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ýsledek
topics JavaScript true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.