Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

list — povezava vnosnega polja s predlogi

Atribut `list` poveže `input` z elementom `datalist`, ki vsebuje predlagane vrednosti. Vnesene vrednosti ne omeji na te predloge.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

<input type="text" list="choices">
<datalist id="choices">
  <option value="HTML"></option>
</datalist>

list se sklicuje na datalist prek njegovega id v istem drevesu. Njegova vrednost je identifikator, ne izbirnik CSS: uporabi topics, ne #topics. Atribut velja samo za ustrezne vrste input, na primer text; za password ne velja.

Elementi option v datalist zagotavljajo predloge. list ne zahteva, da je vnesena vrednost ena od njih: druge omejitve preverjanja veljavnosti še vedno veljajo. Če je treba izbrati vrednost iz zaprtega seznama, uporabi select.

Brskalnik določa prikaz in filtriranje predlogov. Če ustreznega elementa ni, ni na voljo vira predlogov. Pomemben je prvi element z navedenim id; če ni datalist, povezava ni vzpostavljena. Izogibaj se podvojenim ID-jem.

V primeru lastnost DOM input.list vrne povezani datalist. Vrednost JavaScript, ki je ni med predlogi, ostane veljavna, zato je zadnja vrstica izpisa true.

Primeri

<!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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri