blob: 4889ed135afcf09056a56041386ca0fe140481b9 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
---
title: CSSStyleDeclaration.getPropertyCSSValue()
slug: Web/API/CSSStyleDeclaration/getPropertyCSSValue
tags:
- API
- CSSOM
- Method
- Deprecated
- Reference
browser-compat: api.CSSStyleDeclaration.getPropertyCSSValue
translation_of: Web/API/CSSStyleDeclaration/getPropertyCSSValue
---
<p>{{ APIRef("CSSOM") }} {{deprecated_header}}</p>
<p><strong>CSSStyleDeclaration.getPropertyCSSValue()</strong> メソッドインターフェイスは、プロパティの CSS 値を含む {{domxref('CSSValue')}} を返します。プロパティ名が一括指定プロパティの場合は <code>null</code> を返すことに注意して下さい。</p>
<div class="notecard note">
<p><strong>注:</strong> このインターフェースは、型付けされた CSS オブジェクトモデルを作成する試みの一部でした。この試みは放棄されており、ほとんどのブラウザーは実装していません。</p>
<p>この目的を達成するには、以下のものを使用することができます。</p>
<ul>
<li>{{domxref("CSSStyleDeclaration.getPropertyValue()")}} が型付けなしの <a href="/ja/docs/Web/API/CSS_Object_Model">CSS オブジェクトモデル</a>にあり、広く対応されています。</li>
<li>{{domxref("Element.computedStyleMap()")}} が最近の <a href="/ja/docs/Web/API/CSS_Typed_OM_API">CSS 型付きオブジェクトモデル API</a> にありますが、対応が少なく実験的なものと考えられています。</li>
</ul>
</div>
<h2 id="Syntax">構文</h2>
<pre
class="brush: js">var <em>value</em> = <em>style</em>.getPropertyCSSValue(<em>property</em>);</pre>
<h3 id="Parameters">引数</h3>
<ul>
<li><em><code>property</code></em> は、取得するプロパティ名を表す {{domxref('DOMString')}} です。</li>
</ul>
<h3 id="Return_value">返値</h3>
<ul>
<li><code><em>value</em></code> は、プロパティの CSS 値を含む {{domxref('CSSValue')}} です。存在しない場合は <code>null</code> を返します。</li>
</ul>
<h2 id="Example">例</h2>
<p>次の JavaScript コードは、 CSS の <code>color</code> プロパティの計算済みの RGB 値を含むオブジェクトを取得します。</p>
<pre class="brush: js">var style = window.getComputedStyle(elem, null);
var rgbObj = style.getPropertyCSSValue('color').getRGBColorValue();
</pre>
<h2 id="Specifications">仕様書</h2>
<p>この機能はもともと、 <a href="https://www.w3.org/TR/DOM-Level-2-Style">DOM Style Level 2</a> 仕様書で定義されていましたが、それ以降の標準化の取り組みからは外れています。</p>
<p>この機能は、最新の、しかし互換性のない、 <a href="/ja/docs/Web/API/CSS_Typed_OM_API">CSS Typed Object Model API</a> に取って代わられ、現在は標準化されています。</p>
<h2 id="Browser_compatibility">ブラウザーの互換性</h2>
<p>{{Compat}}</p>
|