CKTIS / HTML
element HTML: datalist
Element seznama predlogov ponudi kontrolniku neobvezujoče predlagane vrednosti in dovoli vnos druge veljavne vrednosti.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<input list="cities"><datalist id="cities"><option value="Oslo"></datalist>datalist se poveže z združljivim input prek list, enakega njegovemu id; HTMLInputElement.list vrne razrešeni element ali null.
Predlogi izvirajo iz potomcev option: value je vstavljena vrednost, label jo lahko opiše, prazne ali disabled možnosti pa niso predlogi.
datalist ni select in ne zahteva izbire. Omejitve, kot sta required in pattern, neodvisno preverijo končno vrednost, vmesnik in filtriranje pa se razlikujeta.
Primer prek options prešteje kandidate, vnese vrednost zunaj seznama in z checkValidity() potrdi, da value ni omejena na predloge.
Primeri
<!doctype html>
<meta charset="utf-8">
<label>City <input id="city" name="city" list="cities" value="Oslo"></label>
<datalist id="cities">
<option value="Oslo"></option>
<option value="Tokyo"></option>
<option value=""></option>
<option value="Lima" disabled></option>
</datalist>
<output id="result"></output>
<script>
const city = document.querySelector("#city");
const source = document.querySelector("#cities");
const suggestions = [...source.options].filter(option => option.value && !option.disabled);
city.value = "Reykjavík";
document.querySelector("#result").textContent = `linked=${city.list === source}; options=${source.options.length}; suggestions=${suggestions.length}; unlisted=${city.value}; valid=${city.checkValidity()}`;
</script>
Rezultat
linked=true; options=4; suggestions=2; unlisted=Reykjavík; valid=true
Rezultat potrdi povezavo, dva uporabna predloga in veljavno vrednost zunaj seznama; ne ocenjuje videza izvornega menija.