CKTIS / JavaScript
CSSStyleDeclaration.setProperty — impostare dichiarazioni CSS
Imposta dichiarazioni CSS con setProperty(), passando il nome di una proprietà, un valore e una priorità facoltativa.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
style.setProperty(property, value, priority = "")CSSStyleDeclaration.setProperty modifica una dichiarazione, ad esempio in element.style. È un’API del browser, non una funzionalità ECMAScript. Usa nomi CSS come margin-top, non marginTop; i nomi delle proprietà personalizzate, come --accent, distinguono tra maiuscole e minuscole.
priority accetta "" oppure "important", senza distinzione tra maiuscole e minuscole. Non inserire !important in value. In un blocco di dichiarazioni modificabile, un valore vuoto rimuove la dichiarazione prima che venga verificata la priorità, anche se questa non è valida. Se il valore non è vuoto, una priorità non valida non produce modifiche.
Le proprietà non supportate e i valori non validi non producono modifiche. Un blocco di sola lettura genera NoModificationAllowedError. Il metodo restituisce undefined.
Esempi
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")));Risultato
12px important ""
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.