WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTMLOptionElement.value — Wert einer HTML-Option

Lies oder setze den Wert einer einzelnen HTML-Option. Fehlt das Attribut `value`, dient der Optionstext als Wert. Ein ausdrücklich leerer Wert bleibt dagegen leer.

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

Syntax

option.value
option.value = newValue

HTMLOptionElement.value ist eine les- und schreibbare Eigenschaft eines einzelnen option-Elements. Beim Lesen erhältst du eine Zeichenkette, unabhängig davon, ob die Option ausgewählt ist. Ist das HTML-Attribut value vorhanden, gibt die Eigenschaft dessen Inhalt zurück, auch "". Nur wenn das Attribut fehlt, wird der Wert aus dem Optionstext gebildet: ASCII-Leerraum am Anfang und Ende entfällt, und Folgen solcher Zeichen im Inneren werden durch je ein Leerzeichen ersetzt. Das Attribut label dient dabei nicht als Quelle.

Eine Zuweisung an option.value legt das Attribut value an oder aktualisiert es, ohne den Text oder den Auswahlzustand der Option zu ändern. Mit option.removeAttribute("value") wird wieder der Text als Wert verwendet. Setze einen ausdrücklichen Wert wie "plan-pro", wenn die Kennung auch dann gleich bleiben soll, wenn sich die sichtbare Beschriftung ändert oder übersetzt wird.

Beim Lesen von select.value erhältst du dagegen den Wert der ersten ausgewählten Option in DOM-Baumreihenfolge oder "", wenn nichts ausgewählt ist. Ein leeres Ergebnis beweist also nicht, dass keine Option ausgewählt ist. Die Eigenschaft gehört zur DOM-API des HTML-Standards, nicht zu ECMAScript. Das Beispiel benötigt eine Umgebung mit HTML-DOM.

Beispiele

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

Ergebnis

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

Speichere das Beispiel als HTML-Datei und öffne sie in einem Browser. Die Ausgabe erscheint in der Entwicklerkonsole. `null` bedeutet, dass das Attribut fehlt, nicht dass es leer ist. In der zweiten Zeile ist es vorhanden und enthält `""`. Das Element muss nicht zur Seite hinzugefügt werden.

Zugehörige Lektionen

  • JavaScript · Lektion 43 · Mittlere Stufe · Version: 3

Quellen