blob: 43e40972cbe58ea6c9907d83330cbcdc866850f8 (
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
---
title: CSSStyleDeclaration
slug: Web/API/CSSStyleDeclaration
tags:
- API
- CSSOM
- CSSRule
- Interface
- Reference
browser-compat: api.CSSStyleDeclaration
translation_of: Web/API/CSSStyleDeclaration
---
<div>{{APIRef("CSSOM")}}</div>
<p><strong><code>CSSStyleDeclaration</code></strong> インターフェースは CSS 宣言ブロックのオブジェクトを表し、スタイル情報や様々なスタイルに関するメソッドやプロパティを提供します。</p>
<p><code>CSSStyleDeclaration</code> オブジェクトは、下記の 3 つの API によって使用されます。</p>
<ul>
<li>単一の要素のインラインスタイルを扱う {{DOMxRef("HTMLElement.style")}} から (例: <code><div style="..."></code>)。</li>
<li>{{DOMxRef("CSSStyleSheet")}} API から。例えば <code>document.styleSheets[0].cssRules[0].style</code> は、その文書の最初のスタイルシートの最初の CSS 規則を <code>CSSStyleDeclaration</code> を返します。</li>
<li>{{DOMxRef("Window.getComputedStyle()")}} で、 <code>CSSStyleDeclaration</code> オブジェクトを<strong>読み取り専用</strong>インターフェイスとして返します。</li>
</ul>
<h2 id="属性">属性</h2>
<dl>
<dt>{{DOMxRef("CSSStyleDeclaration.cssText")}}</dt>
<dd>宣言ブロックのテキスト表現です。この属性を設定すると、スタイルが変化します。</dd>
<dt>{{DOMxRef("CSSStyleDeclaration.length")}}{{ReadOnlyInline}}</dt>
<dd>プロパティの数を表します。後述の {{DOMxRef("CSSStyleDeclaration.item()", 'item()')}} メソッドを参照のこと。</dd>
<dt>{{DOMxRef("CSSStyleDeclaration.parentRule")}}{{ReadOnlyInline}}</dt>
<dd>所属する {{DOMxRef("CSSRule")}} を表します。</dd>
</dl>
<h3 id="CSS_Properties">CSS プロパティ</h3>
<dl>
<dt>{{DOMxRef("CSSStyleDeclaration.cssFloat", "CSSStyleDeclaration.cssFloat")}}</dt>
<dd>CSS の {{CSSxRef("float")}} プロパティのエイリアスです。</dd>
<dt>{{DOMxRef("CSSStyleDeclaration.named_properties", '<code>CSSStyleDeclaration</code> の名前付きプロパティ', "", 1)}}</dt>
<dd>対応するすべての CSS プロパティを、ダッシュおよびキャメルケースにした属性です。</dd>
</dl>
<h2 id="Methods">メソッド</h2>
<dl>
<dt>{{DOMxRef("CSSStyleDeclaration.getPropertyPriority()")}}</dt>
<dd>オプションの優先度、 "important" を返します。</dd>
<dt>{{DOMxRef("CSSStyleDeclaration.getPropertyValue()")}}</dt>
<dd>指定されたプロパティ名のプロパティ値を返します。</dd>
<dt>{{DOMxRef("CSSStyleDeclaration.item()")}}</dt>
<dd>位置から CSS プロパティ名を返します。位置が範囲を超えていた場合は空文字列を返します。</dd>
<dd>代替方法は <code>nodeList[<var>i</var>]</code> にアクセスすることです (これは <code><var>i</var></code> が範囲外であった場合は <code>undefined</code> を返します)。これは JavaScript 以外の DOM 実装の多くで最も有用です。</dd>
<dt>{{DOMxRef("CSSStyleDeclaration.removeProperty()")}}</dt>
<dd>CSS 宣言ブロックからプロパティを削除します。</dd>
<dt>{{DOMxRef("CSSStyleDeclaration.setProperty()")}}</dt>
<dd>宣言ブロック内の既存の CSS プロパティを変更するか、新しい CSS プロパティを生成するかします。</dd>
<dt>{{DOMxRef("CSSStyleDeclaration.getPropertyCSSValue()")}} {{deprecated_inline}}</dt>
<dd><strong>Firefox の getComputedStyle のみ対応</strong> プロパティの値を {{DOMxRef("CSSPrimitiveValue")}} として、または<a href="/ja/docs/Web/CSS/Shorthand_properties">一括指定プロパティ</a>では <code>null</code> を返します。</dd>
</dl>
<h2 id="Example">例</h2>
<pre class="brush: js">var styleObj = document.styleSheets[0].cssRules[0].style;
console.log(styleObj.cssText);
for (var i = styleObj.length; i--;) {
var nameString = styleObj[i];
styleObj.removeProperty(nameString);
}
console.log(styleObj.cssText);</pre>
<h2 id="Specifications">仕様書</h2>
{{Specifications}}
<h2 id="Browser_compatibility">ブラウザーの互換性</h2>
<p>{{Compat}}</p>
<h2 id="See_also">関連情報</h2>
<ul>
<li><a href="/en-US/docs/Web/CSS/CSS_Properties_Reference">CSS Properties Reference</a></li>
</ul>
|
