HTMLInputElement: valueAsNumber-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 valueAsNumber-Eigenschaft des HTMLInputElement-Interfaces repräsentiert den aktuellen Wert des <input>-Elements als Zahl oder NaN, wenn eine Umwandlung in einen numerischen Wert nicht möglich ist.

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

Wert

Eine Zahl, die den Wert des Elements darstellt, oder NaN, wenn die numerische Konvertierung unmöglich ist.

Beispiele

Abrufen eines Zahlenwertes

In diesem Beispiel zeigt das Protokoll den aktuellen Wert des number-Eingabefelds, wenn es geändert wird.

HTML

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

html
<label for="number">Pick a number between 1 and 10:</label>

<input name="number" id="number" min="1" max="10" type="number" />

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

JavaScript

Das innerText des <pre>-Elements wird bei jedem change-Ereignis auf den aktuellen Wert des <input>-Elements aktualisiert.

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

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

Ergebnisse

Wenn Sie die Zahl im Widget löschen, ist das Ergebnis NaN.

Abrufen eines Datumswertes als Zahl

Dieses Beispiel demonstriert die valueAsNumber-Eigenschaft eines <input> mit dem Typ datetime-local.

HTML

Wir fügen ein <input> des Typs datetime-local ein:

html
<label for="date">Pick a date and time:</label>

<input name="date" id="date" type="datetime-local" />

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

JavaScript

Wenn kein Datum oder keine Uhrzeit ausgewählt ist, ergibt der leere String NaN. Jedes Mal, wenn eine Auswahl getroffen wird, wird ein change-Ereignis ausgelöst, das den Inhalt des <pre>-Elements aktualisiert und den HTMLInputElement.value des Formularelements im Vergleich zu diesem Wert als Zahl anzeigt.

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

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

inputElement.addEventListener("change", () => {
  const d = new Date(inputElement.valueAsNumber);
  logElement.innerText = `${inputElement.value} resolves to ${inputElement.valueAsNumber}, \nwhich is ${d.toDateString()} at ${d.toTimeString()}`;
});

Ergebnisse

Spezifikationen

Specification
HTML Standard
# dom-input-valueasnumber-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch