CKTIS / JavaScript
HTMLElement.style — vložené styly prvku
HTMLElement.style zpřístupňuje měnitelný objekt s vloženými deklaracemi CSS, nikoli výsledek kaskády.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.style.propertyName = "value";
element.style.setProperty("property-name", "value", "important");
element.style.removeProperty("property-name");HTMLElement.style vždy vrací stejný objekt s vloženými deklaracemi, který je spojen s atributem style. Specifikace jej definuje jako CSSStyleProperties, který dědí z CSSStyleDeclaration.
Používejte názvy ve stylu camelCase, například marginTop, nebo setProperty() s názvy CSS. Pro vlastní vlastnosti použijte setProperty(). Prioritu important zadejte jako třetí argument, nikoli jako součást hodnoty.
removeProperty() odstraní deklaraci; chybějící hodnota se přečte jako "". style nezpřístupňuje výsledek kaskády — k tomu použijte getComputedStyle(). Přiřazení textu do element.style jej předá do cssText a nahradí celý vložený blok, nikoli jen jednu deklaraci.
Příklady
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));Výsledek
true 12px 8px ""
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.