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 CSSStyleDeclaration-Schnittstelle ist die Basisklasse für Objekte, die CSS-Deklarationsblöcke mit verschiedenen unterstützten Sets von CSS-Stilinformationen darstellen:

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

Die Schnittstelle stellt Stilinformationen sowie verschiedene stilbezogene Methoden und Eigenschaften bereit. Beispielsweise bietet sie getPropertyValue() zum Abrufen des Wertes einer Dash-named CSS-Eigenschaft, wie border-top, die aufgrund der Bindestriche im Namen nicht direkt über die Punktnotation zugänglich ist.

Hinweis: Frühere Versionen der Spezifikation verwendeten CSSStyleDeclaration, um alle CSS-Deklarationsblöcke darzustellen, und einige Browser und Browserversionen können dies immer noch tun (überprü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 funktional sein, aber einige in einer CSSStyleDeclaration zurückgegebene Eigenschaften sind möglicherweise nicht in einem bestimmten Kontext relevant.

Attribute

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

CSS Eigenschaften

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

Instanzmethoden

CSSStyleDeclaration.getPropertyPriority(): Gibt die optionale Priorität, "wichtig", zurück.
CSSStyleDeclaration.getPropertyValue(): Gibt den Eigenschaftswert zu einem Eigenschaftsnamen zurück.
CSSStyleDeclaration.item(): Gibt einen CSS-Eigenschaftsnamen nach seinem Index zurück oder den leeren String, wenn der Index außerhalb des Bereichs 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 Shorthand-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