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.