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

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

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

Browser-Kompatibilität