CSSStyleDeclaration: getPropertyCSSValue() method

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{ APIRef("CSSOM") }} {{non-standard_header}}

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

توجه: This interface was part of an attempt to create a typed CSS Object Model. This attempt has been abandoned, and most browsers do not implement it. To achieve your purpose, you can use: - {{domxref("CSSStyleDeclaration.getPropertyValue()")}} of the untyped CSS Object Model, widely supported, or - {{domxref("Element.computedStyleMap()")}} of the modern CSS Typed Object Model API, less supported and considered experimental.

Syntax

js-nolint
getPropertyCSSValue(property)

Parameters

  • property
  • : A string representing the property name to be retrieved.

Return value

A {{domxref('CSSValue')}} containing the CSS value for a property. If none exists, returns null.

Examples

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

js
const style = window.getComputedStyle(elem, null);
const rgbObj = style.getPropertyCSSValue("color").getRGBColorValue();

Specifications

This feature was originally defined in the DOM Style Level 2 specification, but has been dropped from any standardization effort since then.

It has been superseded by a modern, but incompatible, CSS Typed Object Model API that is now on the standard track.

Browser compatibility

{{Compat}}