CSSPrimitiveValue: getFloatValue()-Methode
Deprecated
Avoid using this feature in new projects. The DOM level 2 CSS object model was excluded from the later CSS object model (CSSOM) specification. This feature may be a candidate for removal from web standards or browsers.
Consider using the following features instead: CSS object model.
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 des CSSPrimitiveValue-Interfaces wird verwendet, um einen Gleitkommawert in einer angegebenen Einheit zu erhalten. Wenn dieser CSS-Wert keinen Gleitkommawert 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 ihn nicht.
Um Ihr Ziel zu erreichen, können Sie verwenden:
- das untypisierte CSS-Objektmodell, das weithin 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_CMDer Wert ist ein <length>in Zentimetern.CSS_DEGDer Wert ist ein <angle>in Grad.CSS_DIMENSIONDer Wert ist eine <number>mit unbekannter Dimension.CSS_EMSDer Wert ist ein <length>in em-Einheiten.CSS_EXSDer Wert ist ein <length>in ex-Einheiten.CSS_GRADDer Wert ist ein <angle>in Grads.CSS_HZDer Wert ist eine <frequency>in Hertz. Der Wert kann mit der Methode getFloatValue erhalten werden.CSS_INDer Wert ist ein <length>in Zoll.CSS_KHZDer Wert ist eine <frequency>in Kilohertz.CSS_MMDer Wert ist ein <length>in Millimetern.CSS_MSDer Wert ist eine <time>in Millisekunden.CSS_NUMBERDer Wert ist eine einfache <number>.CSS_PCDer Wert ist ein <length>in Picas.CSS_PERCENTAGEDer Wert ist ein <percentage>.CSS_PTDer Wert ist ein <length>in Punkten.CSS_PXDer Wert ist ein <length>in Pixeln.CSS_RADDer Wert ist ein <angle>in Radianten.CSS_SDer 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 Gleitkommawert enthält oder wenn der Gleitkommawert 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 Feature wurde ursprünglich in der DOM Style Level 2-Spezifikation definiert, wurde jedoch seitdem aus allen Standardisierungsbemühungen entfernt.
Es wurde von einer modernen, aber inkompatiblen CSS Typed Object Model API abgelöst, die sich nun auf dem Standardpfad befindet.