CKTIS / HTML
élément HTML: datalist
L’élément de liste de suggestions fournit à un contrôle des valeurs proposées non contraignantes tout en autorisant une autre valeur valide.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<input list="cities"><datalist id="cities"><option value="Oslo"></datalist>datalist se relie à un input compatible par un attribut list égal à son id ; HTMLInputElement.list renvoie l’élément résolu ou null.
Les suggestions viennent des descendants option : value est la valeur insérée, label peut la décrire et les options vides ou disabled ne sont pas proposées.
datalist n’est pas select et n’impose aucun choix. Des contraintes comme required et pattern valident la valeur finale indépendamment ; interface et filtrage varient selon le navigateur.
L’exemple compte les candidats par options, saisit une valeur absente et appelle checkValidity() pour confirmer que value n’est pas limitée aux suggestions.
Exemples
<!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>
Résultat
linked=true; options=4; suggestions=2; unlisted=Reykjavík; valid=true
Le résultat confirme la liaison, deux suggestions utilisables et une valeur absente valide ; il n’évalue pas l’apparence de la liste native.