Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

HTMLElement.style — estilos inline de um elemento

HTMLElement.style expõe um objeto mutável de declarações CSS inline, não o resultado da cascata.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

element.style.propertyName = "value";
element.style.setProperty("property-name", "value", "important");
element.style.removeProperty("property-name");

HTMLElement.style devolve sempre o mesmo objeto de declarações inline associado ao atributo style. A especificação define-o como CSSStyleProperties, que herda de CSSStyleDeclaration.

Utilize nomes em camelCase, como marginTop, ou setProperty() com nomes CSS. Para propriedades personalizadas, utilize setProperty(). Indique a prioridade important como terceiro argumento, não como parte do valor.

removeProperty() remove uma declaração; um valor inexistente é lido como "". style não expõe o resultado da cascata: para isso, utilize getComputedStyle(). Atribuir texto a element.style encaminha-o para cssText e substitui todo o bloco inline, em vez de uma única declaração.

Exemplos

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
""

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes