Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
HTMLInputElement : propriété list
Baseline
Large disponibilité
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
| Spécification |
|---|
| HTML # dom-input-list-dev |
Compatibilité des navigateurs
Activez JavaScript pour afficher ce tableau de 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>
Aider à améliorer MDN
Cette page a été modifiée le par les contributeur·ice·s du MDN.