CKTIS / JavaScript
CSSStyleDeclaration.setProperty — nastavenie deklarácií CSS
Nastavujte deklarácie CSS pomocou setProperty() zadaním názvu vlastnosti, hodnoty a voliteľnej priority.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
style.setProperty(property, value, priority = "")CSSStyleDeclaration.setProperty mení deklaráciu, napríklad v element.style. Je to rozhranie prehliadača, nie funkcia ECMAScriptu. Používajte názvy CSS, napríklad margin-top, nie marginTop; názvy vlastných vlastností, ako --accent, rozlišujú veľké a malé písmená.
priority prijíma "" alebo "important", pričom pri druhej hodnote nezáleží na veľkosti písmen. Do value nevkladajte !important. V bloku deklarácií, ktorý možno upravovať, prázdna hodnota odstráni deklaráciu ešte pred kontrolou priority, aj keď je priorita neplatná. Pri neprázdnej hodnote neplatná priorita nespôsobí žiadnu zmenu.
Nepodporované vlastnosti a neplatné hodnoty nespôsobia žiadnu zmenu. Blok iba na čítanie vyvolá NoModificationAllowedError. Metóda vracia undefined.
Prí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ýsledok
12px important ""
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.