HTMLInputElement: value-Eigenschaft

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.

Die value-Eigenschaft der HTMLInputElement-Schnittstelle repräsentiert den aktuellen Wert des <input>-Elements als Zeichenkette.

Diese Eigenschaft kann auch direkt gesetzt werden, um beispielsweise einen Standardwert basierend auf einer Bedingung festzulegen.

Wert

Eine Zeichenkette, die den Wert des <input>-Elements enthält, oder eine leere Zeichenkette, wenn das Eingabeelement keinen Wert hat.

Beispiele

Abrufen des Werts einer Texteingabe

In diesem Beispiel wird der aktuelle Wert protokolliert, während der Benutzer Daten in das Eingabefeld eingibt.

HTML

Wir fügen ein <input> und ein zugehöriges <label> sowie einen <pre>-Container für unsere Ausgabe ein.

html
<label for="given-name">Your name:</label>

<input name="given-name" id="given-name" />

<pre id="log"></pre>

JavaScript

Der innerText des <pre>-Elements wird jedes Mal aktualisiert, wenn ein keyup-Ereignis ausgelöst wird, und zwar auf den aktuellen Wert des <input>.

js
const logElement = document.getElementById("log");
const inputElement = document.getElementById("given-name");

inputElement.addEventListener("keyup", () => {
  logElement.innerText = `Name: ${inputElement.value}`;
});

Ergebnisse

Abrufen eines Farbwerts

Dieses Beispiel zeigt, wie die value-Eigenschaft mit einem <input> des Typs color verwendet wird.

HTML

Wir fügen ein <input> des Typs color ein:

html
<label for="color">Pick a color:</label>

<input name="color" id="color" type="color" />

<pre id="log"></pre>

JavaScript

Der innerText des <pre>-Elements wird mit dem Standardfarbwert (#000000) aktualisiert und dann jedes Mal aktualisiert, wenn ein change-Ereignis ausgelöst wird.

js
const logElement = document.getElementById("log");
const inputElement = document.getElementById("color");

logElement.innerText = `Color: ${inputElement.value}`;

inputElement.addEventListener("change", () => {
  logElement.innerText = `Color: ${inputElement.value}`;
});

Ergebnisse

Spezifikationen

Specification
HTML Standard
# dom-input-value

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch