CKTIS / JavaScript
HTMLOptionElement.value — valeur d’une option HTML
Lisez ou définissez la valeur d’une option HTML. Sans attribut `value`, la propriété se rabat sur le texte de l’option ; une valeur explicitement vide reste vide.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
option.value
option.value = newValueHTMLOptionElement.value est une propriété en lecture et en écriture d’un élément option. Sa lecture renvoie une chaîne, que l’option soit sélectionnée ou non. Si l’attribut HTML value est présent, la propriété renvoie son contenu, même si c’est "". Ce n’est qu’en l’absence de l’attribut que la valeur est calculée à partir du texte de l’option : les blancs ASCII en début et en fin sont supprimés, et chaque suite de blancs à l’intérieur est remplacée par une espace. L’attribut label n’est pas la source de cette valeur de repli.
Une affectation à option.value crée ou met à jour l’attribut value sans modifier le texte de l’option ni son état de sélection. option.removeAttribute("value") rétablit le recours au texte. Définissez une valeur explicite telle que "plan-pro" si l’identifiant doit rester stable même quand le libellé affiché change ou est traduit.
À l’inverse, la lecture de select.value donne la valeur de la première option sélectionnée dans l’ordre de l’arbre DOM, ou "" si aucune ne l’est. Un résultat vide ne prouve donc pas qu’aucune option n’est sélectionnée. Cette API du DOM est définie par le standard HTML, pas par ECMAScript ; l’exemple nécessite un environnement qui fournit le DOM HTML.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>HTMLOptionElement.value example</title>
<script>
const option = document.createElement("option");
option.textContent = " Pro\n plan ";
console.log(JSON.stringify([option.value, option.getAttribute("value")]));
option.value = "";
console.log(JSON.stringify([option.value, option.getAttribute("value")]));
option.value = "plan-pro";
console.log(JSON.stringify([option.value, option.text]));
option.removeAttribute("value");
console.log(JSON.stringify([option.value, option.getAttribute("value")]));
</script>Résultat
["Pro plan",null] ["",""] ["plan-pro","Pro plan"] ["Pro plan",null]
Enregistrez l’exemple dans un fichier HTML et ouvrez-le dans un navigateur. Le résultat s’affiche dans la console de développement. `null` indique que l’attribut est absent, pas qu’il est vide : à la deuxième ligne, il est présent et contient `""`. Il n’est pas nécessaire d’ajouter l’élément à la page.
Leçons associées
- JavaScript · Leçon 43 · Intermédiaire · Version : 3