WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

CSSStyleDeclaration.setProperty — CSS-Deklarationen festlegen

Lege mit setProperty() CSS-Deklarationen fest, indem du einen Eigenschaftsnamen, einen Wert und eine optionale Priorität übergibst.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

style.setProperty(property, value, priority = "")

CSSStyleDeclaration.setProperty ändert eine Deklaration, zum Beispiel in element.style. Es handelt sich um eine Browser-API, nicht um eine ECMAScript-Funktion. Verwende CSS-Namen wie margin-top statt marginTop; Namen benutzerdefinierter Eigenschaften wie --accent unterscheiden zwischen Groß- und Kleinschreibung.

Für priority sind "" oder "important" zulässig, wobei bei letzterem die Groß- und Kleinschreibung keine Rolle spielt. Schreibe !important nicht in value. In einem beschreibbaren Deklarationsblock entfernt ein leerer Wert die Deklaration, bevor die Priorität geprüft wird. Das gilt auch bei ungültiger Priorität. Bei einem nicht leeren Wert bewirkt eine ungültige Priorität keine Änderung.

Nicht unterstützte Eigenschaften und ungültige Werte bewirken keine Änderung. Bei einem schreibgeschützten Block wird NoModificationAllowedError ausgelöst. Die Methode gibt undefined zurück.

Beispiele

const style = document.createElement("div").style;
style.setProperty("margin-top", "12px", "important");
console.log(style.getPropertyValue("margin-top"));
console.log(style.getPropertyPriority("margin-top"));
style.setProperty("margin-top", "");
console.log(JSON.stringify(style.getPropertyValue("margin-top")));

Ergebnis

12px
important
""

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen