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.

Want more browser support for this feature? Tell us why.

Die to()-Methode der Schnittstelle CSSNumericValue 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 den die Methode angewendet wird, nicht in einen einzelnen Wert und Typ aufgelöst werden kann. Dies kann vorkommen, wenn der Wert aus einer Variablen berechnet wird, dessen Wert im Kontext nicht bekannt sein kann.
  • Der Wert nicht in die neue Einheit konvertiert werden kann, da 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