CKTIS / HTML
list — collegare un campo di input ai suggerimenti
L’attributo `list` collega un `input` a un `datalist` che contiene valori suggeriti. Non limita il valore inserito a questi suggerimenti.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<input type="text" list="choices">
<datalist id="choices">
<option value="HTML"></option>
</datalist>list fa riferimento a un datalist tramite il suo id nello stesso albero. Il valore è un identificatore, non un selettore CSS: usa topics, non #topics. L’attributo si applica solo ai tipi di input appropriati, come text; non si applica a password.
Gli elementi option in un datalist forniscono suggerimenti. list non impone che il valore inserito corrisponda a uno di essi: le altre condizioni di convalida continuano ad applicarsi. Se è richiesta una selezione da un elenco chiuso, usa select.
Il browser determina la presentazione e il filtraggio dei suggerimenti. Se non c’è un elemento corrispondente, non è disponibile alcuna fonte di suggerimenti. È determinante il primo elemento con l’id specificato; se non è un datalist, non viene stabilita alcuna associazione. Evita gli ID duplicati.
Nell’esempio, la proprietà DOM input.list restituisce il datalist associato. Il valore JavaScript, che non compare nell’elenco, resta valido; perciò l’ultima riga del risultato è true.
Esempi
<!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>Risultato
topics JavaScript true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.