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⁩.

Das CSSStyleDeclaration Interface ist die Basisklasse für Objekte, die CSS-Deklarationsblöcke mit verschiedenen unterstützten Sätzen von CSS-Stilinformationen repräsentieren:

CSSStyleProperties — CSS-Stile, die im Stylesheet deklariert sind (CSSStyleRule.style), Inline-Stile für ein Element wie HTMLElement, SVGElement und MathMLElement oder der berechnete Stil für ein Element, der von Window.getComputedStyle() zurückgegeben wird.
CSSPageDescriptors — Stile für CSS At-Regeln.

Das Interface stellt Stilinformationen und verschiedene stilbezogene Methoden und Eigenschaften zur Verfügung. Zum Beispiel bietet es getPropertyValue() an, um den Wert einer dash-benannten CSS-Eigenschaft, wie border-top, zu erhalten, die nicht direkt über die Punktnotation zugänglich ist, da sie Bindestriche im Namen enthält.

Hinweis: Frühere Versionen der Spezifikation verwendeten CSSStyleDeclaration, um alle CSS-Deklarationsblöcke darzustellen, und einige Browser und Browserversionen tun dies möglicherweise noch (prüfen Sie die Browser-Kompatibilitätstabellen für die oben genannten APIs). Im Allgemeinen wird derselbe Website-Code sowohl in alten als auch in neuen Versionen funktionieren, aber einige in einer CSSStyleDeclaration zurückgegebene Eigenschaften könnten in einem bestimmten Kontext nicht relevant sein.

Attribute

CSSStyleDeclaration.cssText: Textdarstellung des Deklarationsblocks, wenn und nur wenn er über HTMLElement.style zugänglich ist. Das Setzen dieses Attributs ändert den Inline-Stil. Wenn Sie eine Textdarstellung eines berechneten Deklarationsblocks möchten, können Sie diese 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 float CSS-Eigenschaft.
CSSStyleDeclaration benannte Eigenschaften: Mit Bindestrichen 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(): Modifiziert eine bestehende CSS-Eigenschaft oder erstellt eine neue CSS-Eigenschaft im Deklarationsblock.
CSSStyleDeclaration.getPropertyCSSValue() Veraltet: Nur über getComputedStyle in Firefox unterstützt. 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