CSS Declaration Block

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

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

{{DefaultAPISidebar("CSSOM")}}

A CSS declaration block is an ordered collection of CSS properties and values. It is represented in the DOM as a {{domxref("CSSStyleDeclaration")}}.

Each property and value pairing is known as a CSS declaration. The CSS declaration block has the following associated properties:

  • computed flag
  • : Set if the {{domxref("CSSStyleDeclaration")}} object is a computed rather than specified style. Unset by default.
  • declarations
  • : The CSS declarations associated with this object.
  • parent CSS rule
  • : The {{domxref("CSSRule")}} that the CSS declaration block is associated with, otherwise null.
  • owner node
  • : The {{domxref("element")}} that the CSS declaration block is associated with, otherwise null.
  • updating flag
  • : Set when the CSS declaration block is updating the owner node's [style](/en-US/docs/Web/HTML/Reference/Global_attributes/style) attribute.

When a {{domxref("CSSStyleDeclaration")}} is returned by a CSS Object Model (CSSOM) interface these properties are set to appropriate values as defined by the specification.

Basic example

The following example shows a CSS rule with a declaration block for the {{htmlelement("Heading_Elements","h1")}} element. The CSS declaration block is the lines between the curly braces.

css
h1 {
  margin: 0 auto;
  font-family: "Helvetica Neue", "Arial", sans-serif;
  font-style: italic;
  color: rebeccapurple;
}

We can return a {{domxref("CSSStyleDeclaration")}} representing this CSS declaration block using {{domxref("CSSStyleRule.style")}}.

js
let myRules = document.styleSheets[0].cssRules;
let rule = myRules[0]; // a CSSStyleRule
console.log(rule.style); // a CSSStyleDeclaration object

Specifications

{{Specifications}}