CKTIS / JavaScript
CSSStyleDeclaration.setProperty — establecer declaraciones CSS
Establece declaraciones CSS con setProperty(), pasando el nombre de una propiedad, un valor y una prioridad opcional.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
style.setProperty(property, value, priority = "")CSSStyleDeclaration.setProperty modifica una declaración, por ejemplo, en element.style. Es una API del navegador, no una característica de ECMAScript. Usa nombres CSS como margin-top, no marginTop; los nombres de propiedades personalizadas, como --accent, distinguen entre mayúsculas y minúsculas.
priority acepta "" o "important", sin distinguir entre mayúsculas y minúsculas. No incluyas !important en value. En un bloque de declaraciones modificable, un valor vacío elimina la declaración antes de que se compruebe la prioridad, incluso si esta no es válida. Si el valor no está vacío, una prioridad no válida no produce ningún cambio.
Las propiedades no compatibles y los valores no válidos no producen ningún cambio. Un bloque de solo lectura provoca NoModificationAllowedError. El método devuelve undefined.
Ejemplos
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")));Resultado
12px important ""
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.