CKTIS / HTML
list — relier un champ de saisie à des suggestions
L’attribut `list` relie un `input` à un `datalist` contenant des valeurs suggérées. Il ne limite pas la valeur saisie à ces suggestions.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<input type="text" list="choices">
<datalist id="choices">
<option value="HTML"></option>
</datalist>list fait référence à un datalist par son id dans le même arbre. Sa valeur est un identifiant, pas un sélecteur CSS : utilisez topics, et non #topics. L’attribut s’applique uniquement aux types de input appropriés, comme text ; il ne s’applique pas à password.
Les éléments option d’un datalist fournissent des suggestions. list n’impose pas que la valeur saisie figure parmi elles : les autres contraintes de validation restent applicables. Si une sélection dans une liste fermée est nécessaire, utilisez select.
Le navigateur détermine l’affichage et le filtrage des suggestions. En l’absence d’élément correspondant, aucune source de suggestions n’est disponible. Le premier élément portant l’id indiqué est déterminant ; s’il ne s’agit pas d’un datalist, aucune association n’est établie. Évitez les identifiants en double.
Dans l’exemple, la propriété DOM input.list renvoie le datalist associé. La valeur JavaScript, qui ne figure pas dans la liste, reste valide ; la dernière ligne du résultat est donc true.
Exemples
<!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>Résultat
topics JavaScript true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.