| title | slug | l10n | ||
|---|---|---|---|---|
CSSStyleDeclaration.getPropertyCSSValue() |
Web/API/CSSStyleDeclaration/getPropertyCSSValue |
|
{{ APIRef("CSSOM") }} {{deprecated_header}}
CSSStyleDeclaration.getPropertyCSSValue() メソッドインターフェイスは、プロパティの CSS 値を含む {{domxref('CSSValue')}} を返します。プロパティ名が一括指定プロパティの場合は null を返すことに注意して下さい。
Note
このインターフェイスは、型付けされた CSS オブジェクトモデルを作成する試みの一部でした。この試みは放棄されており、ほとんどのブラウザーは実装していません。
この目的を達成するには、以下のものを使用することができます。
- {{domxref("CSSStyleDeclaration.getPropertyValue()")}} が型付けなしの CSS オブジェクトモデルにあり、広く対応されています。
- {{domxref("Element.computedStyleMap()")}} が最近の CSS 型付きオブジェクトモデル API にありますが、対応が少なく実験的なものと考えられています。
getPropertyCSSValue(property)
property- : 文字列で、取得するプロパティ名を表します。
プロパティの CSS 値を含む {{domxref('CSSValue')}} です。存在しない場合は null を返します。
次の JavaScript コードは、 CSS の color プロパティの計算済みの RGB 値を含むオブジェクトを取得します。
const style = window.getComputedStyle(elem, null);
const rgbObj = style.getPropertyCSSValue("color").getRGBColorValue();この機能はもともと、 DOM Style Level 2 仕様書で定義されていましたが、それ以降の標準化の取り組みからは外れています。
この機能は、最新の、しかし互換性のない、 CSS 型付きオブジェクトモデル API に取って代わられ、現在は標準化されています。
{{Compat}}