Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła