Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLSelectElement : méthode namedItem()

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 juillet 2015.

La méthode namedItem() de l'interface HTMLSelectElement retourne un objet HTMLOptionElement correspondant à l'élément HTMLOptionElement dont le name ou l'id correspond au nom défini, ou null si aucune option ne correspond.

En JavaScript, utiliser selectElt.namedItem('value') est équivalent à selectElt.options.namedItem('value').

Syntaxe

js
namedItem(str)

Paramètres

str

Une chaîne de caractères représentant le name ou l'id de l'option.

Valeur de retour

Un objet HTMLOptionElement ou null.

Exemples

HTML

html
<form>
  <select id="myFormControl">
    <option id="o1">Opt 1</option>
    <option id="o2">Opt 2</option>
  </select>
</form>

JavaScript

js
let selectElt = document.getElementById("myFormControl");
elem1 = selectElt.namedItem("o1"); // Retourne l'objet HTMLOptionElement représentant #o1

Mais, vous ne pouvez pas écrire :

js
let selectElt = document.getElementById("myFormControl");
elem1 = selectElt.o1; // Retourne undefined
elem1 = selectElt["o1"]; // Retourne undefined

Spécifications

Specification
HTML
# dom-select-nameditem-dev

Compatibilité des navigateurs

Voir aussi