---
title: CSSStyleDeclaration
slug: Web/API/CSSStyleDeclaration
translation_of: Web/API/CSSStyleDeclaration
---
{{APIRef("CSSOM")}}
CSSStyleDeclaration
インターフェースはCSS宣言ブロックオブジェクトを表し、スタイル情報やスタイル関連のメソッド、プロパティを提供します。
CSSStyleDeclaration
オブジェクトは下記の3つのAPIによって使用されます。
- {{DOMxRef("HTMLElement.style")}}。
DOM要素をインラインスタイルで扱う際。(例, <div style="...">
).
- {{DOMxRef("CSSStyleSheet")}} API。
例えばdocument.styleSheets[0].cssRules[0].style
は、CSSStyleDeclaration
を返します。
- {{DOMxRef("Window.getComputedStyle()")}}。
これは読み取り専用インターフェースとして、CSSStyleDeclaration
オブジェクトを返します。
属性
- {{DOMxRef("CSSStyleDeclaration.cssText")}}
- Textual representation of the declaration block. Setting this attribute changes the style.
CSSブロック宣言をテキスト表示する。この属性を与えることでスタイルを変化させることが可能。
- {{DOMxRef("CSSStyleDeclaration.length")}}{{ReadOnlyInline}}
- プロパティの数を表す。後述の{{DOMxRef("CSSStyleDeclaration.item()", 'item()')}}メソッドを参照のこと。
- {{DOMxRef("CSSStyleDeclaration.parentRule")}}{{ReadOnlyInline}}
- {{DOMxRef("CSSRule")}}を含むコンテナを表す。
CSS プロパティ
- {{DOMxRef("CSSStyleDeclaration.named_properties", "CSSStyleDeclaration.cssFloat")}}
- {{CSSxRef("float")}} CSSプロパティのエイリアス。
- {{DOMxRef("CSSStyleDeclaration.named_properties", '
CSSStyleDeclaration
named properties', "", 1)}}
- 全てのCSSプロパティに対して、その値を取得する。
メソッド
- {{DOMxRef("CSSStyleDeclaration.getPropertyPriority()")}}
- Returns the optional priority, "important".
- {{DOMxRef("CSSStyleDeclaration.getPropertyValue()")}}
- Returns the property value given a property name.
- {{DOMxRef("CSSStyleDeclaration.item()")}}
- Returns a CSS property name by its index, or the empty string if the index is out-of-bounds.
- An alternative to accessing
nodeList[i]
(which instead returns undefined
when i
is out-of-bounds). This is mostly useful for non-JavaScript DOM implementations.
- {{DOMxRef("CSSStyleDeclaration.removeProperty()")}}
- Removes a property from the CSS declaration block.
- {{DOMxRef("CSSStyleDeclaration.setProperty()")}}
- Modifies an existing CSS property or creates a new CSS property in the declaration block.
- {{DOMxRef("CSSStyleDeclaration.getPropertyCSSValue()")}} {{Obsolete_Inline}}
- Only supported via getComputedStyle in Firefox. Returns the property value as a {{DOMxRef("CSSPrimitiveValue")}} or
null
for shorthand properties.
例
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);
仕様
仕様 |
ステータス |
コメント |
{{SpecName('CSSOM', '#the-cssstyledeclaration-interface', 'CSSStyleDeclaration')}} |
{{Spec2('CSSOM')}} |
Merged the DOM Level 2 Style CSS2Properties interface into CSSStyleDeclaration . |
{{SpecName('DOM2 Style', 'css.html#CSS-CSSStyleDeclaration', 'CSSStyleDeclaration')}} |
{{Spec2('DOM2 Style')}} |
Initial definition |
ブラウザー実装状況
{{Compat("api.CSSStyleDeclaration")}}
関連情報