Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri