CKTIS / HTML
elemento HTML: datalist
L’elemento elenco di suggerimenti offre a un controllo valori proposti non vincolanti, consentendo di inserire un altro valore valido.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<input list="cities"><datalist id="cities"><option value="Oslo"></datalist>datalist si collega a un input compatibile tramite list uguale al suo id; HTMLInputElement.list restituisce l’elemento risolto o null.
I suggerimenti provengono dai discendenti option: value è il valore da inserire, label può descriverlo e opzioni vuote o disabled non sono suggerimenti.
datalist non è select e non impone una scelta. Vincoli come required e pattern convalidano indipendentemente il valore finale, mentre interfaccia e filtro variano.
L’esempio conta i candidati tramite options, inserisce un valore fuori elenco e chiama checkValidity() per confermare che value non è limitato ai suggerimenti.
Esempi
<!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>
Risultato
linked=true; options=4; suggestions=2; unlisted=Reykjavík; valid=true
Il risultato conferma collegamento, due suggerimenti utilizzabili e un valore fuori elenco valido; non valuta l’aspetto del menu nativo.