Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.
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 wieHTMLElement,SVGElementundMathMLElement, oder der berechnete Stil für ein Element, das durchWindow.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.styleexponiert ist. Das Setzen dieses Attributs ändert den Inline-Stil. Wenn Sie eine Textdarstellung eines berechneten Deklarationsblocks wünschen, können Sie diese mitJSON.stringify()erhalten. CSSStyleDeclaration.lengthSchreibgeschützt-
Die Anzahl der Eigenschaften. Siehe die
item()-Methode unten. CSSStyleDeclaration.parentRuleSchreibgeschützt-
Die enthaltende
CSSRule.
CSS Eigenschaften
CSSStyleDeclaration.cssFloatVeraltet-
Spezieller Alias für die
floatCSS-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
CSSPrimitiveValueodernullfü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
Loading...