Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti