CKTIS / HTML
prvok HTML: datalist
Prvok zoznamu návrhov poskytuje formulárovému ovládaču nezáväzné navrhnuté hodnoty a dovoľuje zadať inú platnú hodnotu.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<input list="cities"><datalist id="cities"><option value="Oslo"></datalist>datalist sa spojí s kompatibilným input cez list rovné jeho id; HTMLInputElement.list vráti vyriešený prvok alebo null.
Návrhy pochádzajú z potomkov option: value je vkladaná hodnota, label ju môže opísať a prázdne či disabled možnosti nie sú návrhy.
datalist nie je select a nevyžaduje výber. Obmedzenia ako required a pattern overujú konečnú hodnotu nezávisle, zatiaľ čo rozhranie a filtrovanie sa líšia.
Príklad cez options spočíta kandidátov, zadá hodnotu mimo zoznamu a volaním checkValidity() potvrdí, že value nie je obmedzené na návrhy.
Príklady
<!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>
Výsledok
linked=true; options=4; suggestions=2; unlisted=Reykjavík; valid=true
Výsledok potvrdzuje spojenie, dva použiteľné návrhy a platnú hodnotu mimo zoznamu; nehodnotí vzhľad natívnej ponuky.