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 : propriété value

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 propriété value de l'interface HTMLSelectElement contient la valeur du premier élément HTML <option> sélectionné associé à cet élément HTML <select>.

Cette propriété peut également être définie directement, par exemple pour définir une valeur par défaut selon une condition.

Valeur

Une chaîne de caractères contenant la valeur du premier élément <option> sélectionné dans cet élément <select>, ou une chaîne vide si aucune option n'est sélectionnée.

Exemples

Récupérer la valeur sélectionnée

html
<label for="bird-select">Choisissez un oiseau&nbsp;:</label>

<select name="birds" id="bird-select">
  <option value="">--Veuillez choisir une option--</option>
  <option value="Scarlet ibis">Ibis écarlate</option>
  <option value="Marabou stork">Marabout d'Afrique</option>
  <option value="Roseate spoonbill">Spatule rosée</option>
</select>

<pre id="log"></pre>
js
const logElement = document.querySelector("#log");
function log(text) {
  logElement.innerText = text;
}

const select = document.querySelector("#bird-select");
select.addEventListener("change", () => {
  log(`Sélection : ${select.value}`);
});

Spécifications

Specification
HTML
# dom-select-value-dev

Compatibilité des navigateurs

Voir aussi

  • L'élément HTML <select>, qui implémente cette interface.