Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

CSSNumericValue: to() Methode

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Die to() Methode der CSSNumericValue Schnittstelle konvertiert einen numerischen Wert von einer Einheit in eine andere.

Syntax

js
to(unit)

Parameter

unit

Die Einheit, in die Sie konvertieren möchten.

Rückgabewert

Ein CSSUnitValue.

Ausnahmen

SyntaxError DOMException

Wird ausgelöst, wenn eine ungültige Einheit an die Methode übergeben wurde.

TypeError

Wird ausgelöst, wenn:

  • Der CSSNumericValue, auf dem die Methode aufgerufen wird, nicht auf einen einzigen Wert und Typ aufgelöst werden kann. Dies könnte passieren, wenn der Wert aus einer Variablen berechnet wird, deren Wert im Kontext nicht bekannt sein kann.
  • Der Wert nicht in die neue Einheit umgewandelt werden kann, weil er nicht zur gleichen Kategorie gehört. Zum Beispiel kann man Meter nicht in Sekunden umwandeln.

Beispiele

Grundlegende Verwendung

js
// Prints "0.608542cm"
console.log(CSS.px("23").to("cm").toString());

Spezifikationen

Spezifikation
CSS Typed OM Level 1
# dom-cssnumericvalue-to

Browser-Kompatibilität