CKTIS / JavaScript
CSSStyleDeclaration.setProperty — nastavení deklarací CSS
Nastavujte deklarace CSS pomocí setProperty() předáním názvu vlastnosti, hodnoty a volitelné priority.
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
style.setProperty(property, value, priority = "")CSSStyleDeclaration.setProperty mění deklaraci, například v element.style. Jde o rozhraní prohlížeče, nikoli o funkci ECMAScriptu. Používejte názvy CSS, například margin-top, nikoli marginTop; názvy vlastních vlastností, jako --accent, rozlišují velká a malá písmena.
priority přijímá "" nebo "important", přičemž u druhé hodnoty nezáleží na velikosti písmen. Do value nevkládejte !important. V bloku deklarací, který lze upravovat, prázdná hodnota odstraní deklaraci ještě před kontrolou priority, a to i v případě, že je priorita neplatná. U neprázdné hodnoty neplatná priorita nezpůsobí žádnou změnu.
Nepodporované vlastnosti a neplatné hodnoty nezpůsobí žádnou změnu. Blok pouze pro čtení vyvolá NoModificationAllowedError. Metoda vrací undefined.
Příklady
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")));Výsledek
12px important ""
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.