CKTIS / JavaScript
CSSStyleDeclaration.setProperty — ustawianie deklaracji CSS
Ustawiaj deklaracje CSS metodą setProperty(), przekazując nazwę właściwości, wartość i opcjonalny priorytet.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
style.setProperty(property, value, priority = "")CSSStyleDeclaration.setProperty zmienia deklarację, np. w element.style. To API przeglądarki, nie funkcja ECMAScript. Używaj nazw CSS takich jak margin-top, nie marginTop; nazwy właściwości niestandardowych, np. --accent, rozróżniają wielkość liter.
priority przyjmuje "" lub "important" bez rozróżniania wielkości liter. Nie umieszczaj !important w value. W bloku deklaracji, który można modyfikować, pusta wartość usuwa deklarację przed sprawdzeniem priorytetu, nawet jeśli priorytet jest nieprawidłowy. Przy niepustej wartości nieprawidłowy priorytet nie powoduje zmiany.
Nieobsługiwane właściwości i nieprawidłowe wartości nie powodują zmiany. Blok tylko do odczytu powoduje NoModificationAllowedError. Metoda zwraca undefined.
Przykłady
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")));Wynik
12px important ""
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.