CSSStyleDeclaration: Methode getPropertyCSSValue()

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 CSSStyleDeclaration.getPropertyCSSValue() Methodenschnittstelle gibt ein CSSValue-Objekt zurück, das den CSS-Wert für eine Eigenschaft enthält. Beachten Sie, dass null zurückgegeben wird, wenn der Eigenschaftsname eine Kurzschreibweise 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:

Syntax

js
getPropertyCSSValue(property)

Parameter

property

Ein String, der den Namen der abzurufenden Eigenschaft darstellt.

Rückgabewert

Ein CSSValue-Objekt, 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 color-CSS-Eigenschaft enthält:

js
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, aber seitdem aus jeder Standardisierungsanstrengung entfernt.

Sie wurde durch eine moderne, aber inkompatible CSS Typed Object Model API ersetzt, die sich jetzt auf dem Standardisierungspfad befindet.

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
getPropertyCSSValue
Deprecated

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Deprecated. Not for use in new websites.
See implementation notes.