HTMLInputElement : propriété list
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis mars 2019.
La propriété en lecture seule list de l'interface HTMLInputElement retourne le HTMLDataListElement pointé par l'attribut HTML list de l'élément, ou null si l'attribut list n'est pas défini ou si la valeur de l'attribut list n'est associée à aucun <datalist> dans le même arbre.
Note :
Il s'agit d'une propriété en lecture seule. Pour associer un <datalist> à un élément, définissez la valeur de l'attribut list avec setAttribute().
Valeur
Un objet HTMLDataListElement ou null.
Exemple
Étant donné le HTML suivant :
<label for="planet">De quelle planète venez-vous ?</label>
<input id="planet" type="text" list="superhero" />
<datalist id="superhero">
<option value="Azarath"></option>
<option value="Krypton"></option>
<option value="Tamaran"></option>
</datalist>
Vous pouvez récupérer l'élément <datalist> associé à l'élément <input> :
const inputElement = document.querySelector("#planet");
console.log(inputElement.list); // retourne le HTMLDatalistElement du superhero
Spécifications
| Specification |
|---|
| HTML # dom-input-list-dev |
Compatibilité des navigateurs
Voir aussi
- La propriété
HTMLInputElement.value - La propriété
HTMLInputElement.type - L'interface
HTMLDataListElement - L'interface
HTMLOptionElement - L'interface
HTMLCollection - L'élément HTML
<input> - L'élément HTML
<datalist> - L'élément HTML
<option>