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.

Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.

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 konvertiert 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 verwenden:

das untypisierte CSS-Objektmodell, das weit verbreitet unterstützt wird, oder
das moderne CSS-Typed-Object-Model-API, das weniger unterstützt und als experimentell betrachtet wird.

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 Grads.
`CSS_HZ`	Der Wert ist eine `<frequency>` in Hertz. Der Wert kann durch die Methode getFloatValue erlangt 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 Radiant.
`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 konvertiert werden kann.

Beispiele

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

Spezifikationen

Dieses Feature wurde ursprünglich in der DOM Style Level 2-Spezifikation definiert, wurde jedoch seitdem aus allen Standardisierungsbemühungen entfernt.

Es wurde durch ein modernes, aber inkompatibles CSS Typed Object Model API ersetzt, das sich jetzt auf dem Standardpfad befindet.

Browser-Kompatibilität

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden