CSSStyleDeclaration

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Juli 2015⁩.

Die Schnittstelle CSSStyleDeclaration repräsentiert ein Objekt, das einen CSS-Deklarationsblock darstellt, und bietet Stilinformationen sowie verschiedene stilbezogene Methoden und Eigenschaften an.

Ein CSSStyleDeclaration-Objekt kann über drei verschiedene APIs bereitgestellt werden:

Über HTMLElement.style, das mit den Inline-Stilen eines einzelnen Elements arbeitet (z.B. <div style="…">).
Über die CSSStyleSheet API. Zum Beispiel gibt document.styleSheets[0].cssRules[0].style ein CSSStyleDeclaration-Objekt der ersten CSS-Regel im ersten Stylesheet des Dokuments zurück.
Über Window.getComputedStyle(), welches das CSSStyleDeclaration-Objekt als eine schreibgeschützte Schnittstelle bereitstellt.

Attribute

CSSStyleDeclaration.cssText: Textuelle Darstellung des Deklarationsblocks, und nur wenn es über HTMLElement.style bereitgestellt wird. Das Setzen dieses Attributs ändert den Inline-Stil. Wenn Sie eine Textdarstellung eines berechneten Deklarationsblocks wünschen, können Sie dies mit JSON.stringify() erhalten.
CSSStyleDeclaration.length Schreibgeschützt: Die Anzahl der Eigenschaften. Siehe die Methode item() unten.
CSSStyleDeclaration.parentRule Schreibgeschützt: Die enthaltene CSSRule.

CSS-Eigenschaften

CSSStyleDeclaration.cssFloat Veraltet: Spezieller Alias für die CSS-Eigenschaft float.
CSSStyleDeclaration benannte Eigenschaften: Mit Bindestrich und camel-cased Attribute für alle unterstützten CSS-Eigenschaften.

Instanzmethoden

CSSStyleDeclaration.getPropertyPriority(): Gibt die optionale Priorität "important" zurück.
CSSStyleDeclaration.getPropertyValue(): Gibt den Eigenschaftswert für einen gegebenen Eigenschaftsnamen zurück.
CSSStyleDeclaration.item(): Gibt einen CSS-Eigenschaftsnamen anhand seines Indexes zurück oder einen leeren String, wenn der Index außerhalb der Grenzen liegt.
CSSStyleDeclaration.removeProperty(): Entfernt eine Eigenschaft aus dem CSS-Deklarationsblock.
CSSStyleDeclaration.setProperty(): Ändert eine bestehende CSS-Eigenschaft oder erstellt eine neue CSS-Eigenschaft im Deklarationsblock.
CSSStyleDeclaration.getPropertyCSSValue() Veraltet: Nur unterstützt über getComputedStyle in Firefox. Gibt den Eigenschaftswert als CSSPrimitiveValue oder null für Kurzschreibweise-Eigenschaften zurück.

Beispiel

const styleObj = document.styleSheets[0].cssRules[0].style;
console.log(styleObj.cssText);

for (let i = styleObj.length; i--; ) {
  const nameString = styleObj[i];
  styleObj.removeProperty(nameString);
}

console.log(styleObj.cssText);

Spezifikationen

Specification
CSS Object Model (CSSOM) # the-cssstyledeclaration-interface

Browser-Kompatibilität

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden