Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes