Option()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/fr/web/api/html_dom_api/index.md)

Le constructeur Option() permet de créer un nouvel objet HTMLOptionElement.

Syntaxe

js
var optionElementReference = new Option(text, value, defaultSelected, selected);

Parameters

text Facultatif

Une chaîne de caractères DOMString représentant le contenu de l'élément, c'est-à-dire le texte affiché. Si cet argument n'est pas spécifié, c'est la chaîne vide qui sera utilisée.

value Facultatif

Une chaîne de caractères DOMString représentant la valeur de HTMLOptionElement, c'est-à-dire l'attribut HTML value de l'élément <option>. Si cet argument n'est pas fourni, ce sera la valeur de text qui sera reprise comme valeur (par exemple pour l'élément <select> associé lorsque le formulaire est envoyé au serveur).

defaultSelected Facultatif

Un Boolean qui définit la valeur de l'attribut selected, c'est-à-dire que cette <option> sera la valeur par défaut sélectionné dans l'élément <select> lors du premier chargement de la page. S'il n'est pas spécifié, la valeur false sera utilisée par défaut.

selected Facultatif

Un Boolean qui définit l'état sélectionné de l'option, la valeur par défaut est false (non sélectionné). Si cet argument est absent et même si l'argument defaultSelected vaut true, l'option ne sera pas pas sélectionnée.

Exemples

Ajouter de nouvelles options

js
/* Imaginons qu'on ait le code HTML suivant dans le document
<select id='s'>

</select>
*/

var s = document.getElementById("s");
var options = [Quatre, Cinq, Six];

options.forEach(function (element, key) {
  s[key] = new Option(element, key);
});

Ajouter des options avec différents paramètres

js
/* Imaginons qu'ont ait le code HTML suivant dans le document
<select id="s">
  <option>Premier</option>
  <option>Deuxième</option>
  <option>Troisième</option>
</select>
*/

var s = document.getElementById("s");
var options = ["zéro", "un", "deux"];

options.forEach(function (element, key) {
  if (element == "zéro") {
    s[s.options.length] = new Option(element, s.options.length, false, false);
  }
  if (element == "un") {
    s[s.options.length] = new Option(element, s.options.length, true, false); // Ajouter l'attribut "selected"
  }
  if (element == "deux") {
    s[s.options.length] = new Option(element, s.options.length, false, true); // Sélectionnera l'option
  }
});

/* Résultat dans le DOM / HTML modifié :
<select id="s">
  <option value="0">zéro</option>
  <option value="1" selected="">un</option>
  <option value="2">deux</option> // L'utilisateur verra cette option sélectionnée
</select>
*/

Spécifications

Specification
HTML Standard
# dom-option-dev

Compatibilité des navigateurs

BCD tables only load in the browser