Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła