CSSStyleDeclaration: getPropertyCSSValue() 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 CSSStyleDeclaration.getPropertyCSSValue()
Methodenschnittstelle gibt ein CSSValue zurück, das den CSS-Wert für eine Eigenschaft enthält. Beachten Sie, dass sie null zurückgibt, wenn der Eigenschaftsname eine Kurzform-Eigenschaft ist.
Hinweis: Diese Schnittstelle 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:
CSSStyleDeclaration.getPropertyValue()des untypisierten CSS-Objektmodells, das weitgehend unterstützt wird, oderElement.computedStyleMap()der modernen CSS Typed Object Model API, die weniger unterstützt wird und als experimentell gilt.
Syntax
getPropertyCSSValue(property)
Parameter
property-
Ein String, der den zu abfragenden Eigenschaftsnamen darstellt.
Rückgabewert
Ein CSSValue, das den CSS-Wert für eine Eigenschaft enthält. Wenn keiner existiert, wird null zurückgegeben.
Beispiele
Der folgende JavaScript-Code erhält ein Objekt, das die berechneten RGB-Werte der color CSS-Eigenschaft enthält:
const style = window.getComputedStyle(elem, null);
const rgbObj = style.getPropertyCSSValue("color").getRGBColorValue();
Spezifikationen
Diese Funktion wurde ursprünglich in der DOM Style Level 2 Spezifikation definiert, wurde jedoch seitdem aus allen Standardisierungsbemühungen gestrichen.
Sie wurde durch eine moderne, jedoch inkompatible CSS Typed Object Model API ersetzt, die sich nun auf dem Standardisierungspfad befindet.