Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje