CKTIS / JavaScript
HTMLElement.style — estilos en línea de un elemento
HTMLElement.style expone un objeto mutable de declaraciones CSS en línea, no el resultado de la cascada.
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
element.style.propertyName = "value";
element.style.setProperty("property-name", "value", "important");
element.style.removeProperty("property-name");HTMLElement.style siempre devuelve el mismo objeto de declaraciones en línea asociado al atributo style. La especificación lo define como CSSStyleProperties, que hereda de CSSStyleDeclaration.
Usa nombres en camelCase, como marginTop, o setProperty() con nombres CSS. Para las propiedades personalizadas, usa setProperty(). Indica la prioridad important como tercer argumento, no como parte del valor.
removeProperty() elimina una declaración; si no hay valor, se obtiene "". style no expone el resultado de la cascada: para eso, usa getComputedStyle(). Asignar texto a element.style lo pasa a cssText y reemplaza todo el bloque en línea, no una sola declaración.
Ejemplos
const element = document.createElement("div");
const style = element.style;
style.marginTop = "12px";
style.setProperty("--gap", "8px");
console.log(style === element.style);
console.log(style.marginTop);
console.log(style.getPropertyValue("--gap"));
style.removeProperty("margin-top");
console.log(JSON.stringify(style.marginTop));Resultado
true 12px 8px ""
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.