Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje