CSSStyleDeclaration: getPropertyCSSValue() Methode
Deprecated
Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.
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 Schnittstelle der Methode CSSStyleDeclaration.getPropertyCSSValue() gibt ein CSSValue zurück, das den CSS-Wert für eine Eigenschaft enthält. Beachten Sie, dass null zurückgegeben wird, 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 es nicht.
Um Ihr Ziel zu erreichen, können Sie verwenden:
CSSStyleDeclaration.getPropertyValue()des untypisierten CSS Object Model, das breit unterstützt wird, oderElement.computedStyleMap()der modernen, aber weniger unterstützten und als experimentell angesehenen CSS Typed Object Model API.
Syntax
getPropertyCSSValue(property)
Parameter
property-
Ein String, der den abzurufenden Eigenschaftsnamen darstellt.
Rückgabewert
Ein CSSValue, das den CSS-Wert für eine Eigenschaft enthält. Falls keiner existiert, wird null zurückgegeben.
Beispiele
Der folgende JavaScript-Code erhält ein Objekt, das die berechneten RGB-Werte der CSS-Eigenschaft color 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 Standardisierungsbestrebungen entfernt.
Sie wurde durch ein modernes, aber inkompatibles CSS Typed Object Model API ersetzt, das sich nun in der Standardisierungsphase befindet.