CKTIS / JavaScript
CSSStyleDeclaration.setProperty — nastavljanje deklaracij CSS
Deklaracije CSS nastavljajte z metodo setProperty(), tako da podate ime lastnosti, vrednost in izbirno prednost.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
style.setProperty(property, value, priority = "")CSSStyleDeclaration.setProperty spremeni deklaracijo, na primer v element.style. To je API brskalnika, ne funkcija ECMAScripta. Uporabljajte imena CSS, kot je margin-top, ne marginTop; imena lastnosti po meri, kot je --accent, razlikujejo med velikimi in malimi črkami.
priority sprejema "" ali "important", pri čemer velikost črk ni pomembna. V value ne vstavljajte !important. V bloku deklaracij, ki ga je mogoče spreminjati, prazna vrednost odstrani deklaracijo, še preden se preveri prednost, tudi če je ta neveljavna. Če vrednost ni prazna, neveljavna prednost ne povzroči spremembe.
Nepodprte lastnosti in neveljavne vrednosti ne povzročijo spremembe. Blok, ki je samo za branje, sproži NoModificationAllowedError. Metoda vrne undefined.
Primeri
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")));Rezultat
12px important ""
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.