CSSStyleDeclaration

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Das CSSStyleDeclaration-Interface ist die Basisklasse für Objekte, die CSS-Deklarationsblöcke mit verschiedenen unterstützten Sets von CSS-Style-Informationen darstellen:

CSSStyleProperties — CSS-Styles, die in einem Stylesheet deklariert sind (CSSStyleRule.style), Inline-Styles für ein Element wie HTMLElement, SVGElement und MathMLElement oder den berechneten Stil für ein Element, der von Window.getComputedStyle() zurückgegeben wird.
CSSPageDescriptors — Styles für CSS-at-rules.

Das Interface stellt Stil-Informationen sowie verschiedene methoden- und eigenschaftsbezogene Methoden bereit. Zum Beispiel bietet es getPropertyValue() an, um den Wert einer CSS-Eigenschaft mit Bindestrich im Namen, wie z.B. border-top, abzurufen, die nicht direkt per Punktnotation angesprochen werden kann, 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 könnten dies immer noch tun (prüfen Sie die Browser-Kompatibilitätstabellen für die oben genannten APIs). In der Regel wird derselbe Website-Code sowohl in alten als auch in neuen Versionen funktionsfähig sein, aber einige Eigenschaften, die in einem CSSStyleDeclaration zurückgegeben werden, könnten in einem bestimmten Kontext nicht relevant sein.

In diesem Artikel

Attribute

CSSStyleDeclaration.cssText

Textuelle Darstellung des Deklarationsblocks, wenn und nur wenn er über HTMLElement.style zugänglich ist. Das Setzen dieses Attributs verä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

Spezieller Alias für die float CSS-Eigenschaft.

CSSStyleDeclaration benannte Eigenschaften

In Bindestrich- und Camel-Case-Schreibweise 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 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()

Nur über getComputedStyle in Firefox unterstützt. Gibt den Eigenschaftswert als CSSPrimitiveValue oder null für Kurzschrift-Eigenschaften zurück.

Beispiel

js
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

Spezifikation

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

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

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

CSS Object Model (CSSOM)
CSSStyleDeclaration
Instanzeigenschaften
Instanzmethoden
Verwandte Seiten für CSSOM
Anleitungen
1. CSS Declaration
2. CSS-Deklarationsblock
3. Bestimmung der Dimensionen von Elementen
4. Verwaltung der Bildschirmorientierung
5. Verwenden dynamischer Styling-Informationen
6. CSS-Wertserialisierung