CKTIS / JavaScript
HTMLElement.style — style wpisane bezpośrednio w elemencie
HTMLElement.style udostępnia modyfikowalny obiekt deklaracji CSS inline, a nie wynik kaskady.
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
element.style.propertyName = "value";
element.style.setProperty("property-name", "value", "important");
element.style.removeProperty("property-name");HTMLElement.style zwraca zawsze ten sam obiekt deklaracji inline powiązany z atrybutem style. Specyfikacja określa go jako CSSStyleProperties, dziedziczący po CSSStyleDeclaration.
Używaj nazw camelCase, np. marginTop, albo setProperty() z nazwą CSS. Dla właściwości niestandardowych używaj setProperty(). Priorytet important podawaj jako trzeci argument, nie część wartości.
removeProperty() usuwa deklarację; brakująca wartość daje "". style nie pokazuje wyniku kaskady — do tego służy getComputedStyle(). Przypisanie tekstu do element.style przekazuje go do cssText, zastępując cały blok inline zamiast pojedynczej deklaracji.
Przykłady
const element = document.createElement("div");
const style = element.style;
style.marginTop = "12px";
style.setProperty("--gap", "8px");
console.log(style === element.style);
console.log(style.marginTop);
console.log(style.getPropertyValue("--gap"));
style.removeProperty("margin-top");
console.log(JSON.stringify(style.marginTop));Wynik
true 12px 8px ""
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.