CSSPrimitiveValue: getFloatValue() Methode

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Die getFloatValue()-Methode der CSSPrimitiveValue-Schnittstelle wird verwendet, um einen Fließkommawert in einer angegebenen Einheit zu erhalten. Wenn dieser CSS-Wert keinen Fließkommawert enthält oder nicht in die angegebene Einheit umgewandelt werden kann, wird eine DOMException ausgelöst.

Hinweis: Diese Methode war Teil eines Versuchs, ein typisiertes CSS-Objektmodell zu erstellen. Dieser Versuch wurde aufgegeben, und die meisten Browser implementieren es nicht.

Um Ihr Ziel zu erreichen, können Sie Folgendes verwenden:

Das untypisierte CSS-Objektmodell, das weitgehend unterstützt wird, oder
die moderne CSS Typed Object Model API, die weniger unterstützt wird und als experimentell gilt.

Syntax

getFloatValue(unit)

Parameter

unit

Ein unsigned short, der den Code für den Einheitstyp darstellt, in dem der Wert zurückgegeben werden soll. Gültige Werte sind:

Konstante	Beschreibung
`CSS_CM`	Der Wert ist eine `<length>` in Zentimetern.
`CSS_DEG`	Der Wert ist ein `<angle>` in Grad.
`CSS_DIMENSION`	Der Wert ist eine `<number>` mit einer unbekannten Dimension.
`CSS_EMS`	Der Wert ist eine `<length>` in em-Einheiten.
`CSS_EXS`	Der Wert ist eine `<length>` in ex-Einheiten.
`CSS_GRAD`	Der Wert ist ein `<angle>` in Graden.
`CSS_HZ`	Der Wert ist eine `<frequency>` in Hertz. Der Wert kann mit der getFloatValue-Methode erhalten werden.
`CSS_IN`	Der Wert ist eine `<length>` in Zoll.
`CSS_KHZ`	Der Wert ist eine `<frequency>` in Kilohertz.
`CSS_MM`	Der Wert ist eine `<length>` in Millimetern.
`CSS_MS`	Der Wert ist eine `<time>` in Millisekunden.
`CSS_NUMBER`	Der Wert ist eine einfache `<number>`.
`CSS_PC`	Der Wert ist eine `<length>` in Picas.
`CSS_PERCENTAGE`	Der Wert ist eine `<percentage>`.
`CSS_PT`	Der Wert ist eine `<length>` in Punkten.
`CSS_PX`	Der Wert ist eine `<length>` in Pixeln.
`CSS_RAD`	Der Wert ist ein `<angle>` in Radians.
`CSS_S`	Der Wert ist eine `<time>` in Sekunden.

Rückgabewert

Ein float-Wert in der angegebenen Einheit.

Ausnahmen

Typ	Beschreibung
`DOMException`	Ein `INVALID_ACCESS_ERR` wird ausgelöst, wenn der CSS-Wert keinen Fließkommawert enthält oder wenn der Fließkommawert nicht in die angegebene Einheit umgewandelt werden kann.

Beispiele

const cs = window.getComputedStyle(document.body);
const cssValue = cs.getPropertyCSSValue("margin-top");
console.log(cssValue.getFloatValue(CSSPrimitiveValue.CSS_CM));

Spezifikationen

Dieses Merkmal wurde ursprünglich in der DOM Style Level 2-Spezifikation definiert, ist aber seitdem aus allen Standardisierungsbemühungen herausgenommen worden.

Es wurde von einer modernen, aber nicht kompatiblen CSS Typed Object Model API abgelöst, die sich nun auf dem Standardisierungspfad befindet.

Browser-Kompatibilität

BCD tables only load in the browser