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