WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

Das HTML-Attribut value

Das Attribut value hat je nach Element eine andere Bedeutung: Es kann den Wert eines Steuerelements, übermittelte Formulardaten, einen Messwert, einen Fortschritt, die Nummer eines Listeneintrags oder eine maschinenlesbare Darstellung angeben. Es ist kein globales Attribut.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

value="..."

value hat nicht für alle Elemente dieselbe Bedeutung. Syntax und Verhalten hängen vom Element und bei input zusätzlich von type ab. Im HTML-Quelltext ist es ein Textattribut, dessen Inhalt ein Element jedoch als Zahl oder in einem anderen festgelegten Format interpretieren kann.

Bei einem Text-input legt das Attribut den Standardwert fest; die DOM-Eigenschaft .value gibt den aktuellen Wert wieder. Nach einer Bearbeitung durch den Benutzer oder einer Zuweisung an .value können beide voneinander abweichen. Bei checkbox und radio bestimmt value den übermittelten Wert, nicht den Auswahlzustand. Bei input type="file" darf das Attribut value nicht angegeben werden.

Bei button bestimmt value den Wert, der unter seinem name übermittelt wird, wenn die Schaltfläche das Formular absendet; die Beschriftung stammt aus dem Inhalt der Schaltfläche. Bei option gibt es den Wert der Option an. Wird das Attribut weggelassen, wird dieser Wert aus dem Optionstext abgeleitet.

Bei meter ist das erforderliche value ein numerischer Messwert im Bereich min–max (Standard: 0–1). Bei progress gibt es den erledigten Fortschritt von 0 bis max an (Standard: 1). Fehlt value, ist der Fortschritt unbestimmt, nicht null. Beide erfordern eine gültige HTML-Gleitkommazahl.

Bei einem li in einer ol-Liste ist value eine ganze Zahl, die die Ordnungsnummer des Eintrags und die nachfolgende Nummerierung festlegt. Verwende es nicht bei einem Kind von ul oder menu. Bei data ist es erforderlich und enthält eine maschinenlesbare Darstellung des sichtbaren Inhalts. Das Beispiel zeigt den Unterschied zwischen dem Attribut eines Text-input und seinem aktuellen .value.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Attribute and current value</title>
<label>City <input id="city" value="Paris"></label>
<pre id="result"></pre>
<script>
  const city = document.getElementById('city');
  city.value = 'Rome';
  document.getElementById('result').textContent =
    city.getAttribute('value') + '\n' + city.value;
</script>
</html>

Ergebnis

Paris
Rome

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen