KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTMLOptionElement.value — waarde van een HTML-optie

Lees of stel de waarde van één HTML-optie in. Ontbreekt het attribuut `value`, dan wordt de tekst van de optie gebruikt. Een expliciet lege waarde blijft leeg.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

option.value
option.value = newValue

HTMLOptionElement.value is een leesbare en schrijfbare eigenschap van één option-element. Bij het uitlezen krijg je een tekenreeks, ongeacht of de optie geselecteerd is. Als het HTML-attribuut value aanwezig is, geeft de eigenschap de inhoud ervan terug, ook als die "" is. Alleen als het attribuut ontbreekt, wordt de waarde afgeleid van de optietekst: ASCII-witruimte aan het begin en einde verdwijnt en elke reeks witruimtetekens binnenin wordt één spatie. Het attribuut label is niet de bron voor deze terugvalwaarde.

Een toewijzing aan option.value maakt het attribuut value aan of werkt het bij, zonder de tekst of selectiestatus van de optie te veranderen. Met option.removeAttribute("value") wordt de tekst weer als waarde gebruikt. Stel een expliciete waarde zoals "plan-pro" in als de identificatiecode gelijk moet blijven wanneer het zichtbare label verandert of wordt vertaald.

Bij het uitlezen van select.value krijg je daarentegen de waarde van de eerste geselecteerde optie in de volgorde van de DOM-boom, of "" als er geen optie geselecteerd is. Een lege uitkomst bewijst dus niet dat er niets geselecteerd is. Deze DOM-API is vastgelegd in de HTML-standaard en maakt geen deel uit van ECMAScript. Voor het voorbeeld heb je een omgeving met een HTML-DOM nodig.

Voorbeelden

<!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>

Resultaat

["Pro plan",null]
["",""]
["plan-pro","Pro plan"]
["Pro plan",null]

Sla het voorbeeld op als HTML-bestand en open het in een browser. De uitvoer verschijnt in de ontwikkelaarsconsole. `null` betekent dat het attribuut ontbreekt, niet dat het leeg is: op de tweede regel is het aanwezig en bevat het `""`. Je hoeft het element niet aan de pagina toe te voegen.

Gerelateerde lessen

  • JavaScript · Les 43 · Gemiddeld · Versie: 3

Bronnen