CSSStyleDeclaration.getPropertyCSSValue()

Obsolete
This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.

The CSSStyleDeclaration.getPropertyCSSValue() method interface returns a CSSValue containing the CSS value for a property. Note that it returns null if the property name is a shorthand property.

You should use CSSStyleDeclaration.getPropertyValue() instead.

Syntax

var value = style.getPropertyCSSValue(property);

Parameters

  • property is a DOMString representing the property name to be retrieved.

Return value

  • value is a CSSValue containing the CSS value for a property. If none exists, returns null.

Example

The following JavaScript code gets an object containing the computed RGB values of the color CSS property:

var style = window.getComputedStyle(elem, null);
var rgbObj = style.getPropertyCSSValue('color').getRGBColorValue();

Specifications

Specification Status Comment
Document Object Model (DOM) Level 2 Style Specification
The definition of 'CSSStyleDeclaration' in that specification.
Obsolete Declared as obsolete in July 2003.

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support Yes — 411 No Yes — 622 No15 — 281 Yes
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support Yes Yes — 411 No Yes — 6215 — 281 Yes ?

1. See bug 331608.

2. Only returns a result if called on the result of getComputedStyle().

Document Tags and Contributors

Contributors to this page: connorshea, chrisdavidmills, david_ross, Qantas94Heavy
Last updated by: connorshea,