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

CKTIS / JavaScript

CSSStyleDeclaration.setProperty — definir declarações CSS

Defina declarações CSS com setProperty(), indicando o nome de uma propriedade, um valor e uma prioridade opcional.

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

style.setProperty(property, value, priority = "")

CSSStyleDeclaration.setProperty altera uma declaração, por exemplo, em element.style. É uma API do navegador, não uma funcionalidade ECMAScript. Utilize nomes CSS como margin-top, e não marginTop; os nomes das propriedades personalizadas, como --accent, distinguem maiúsculas de minúsculas.

priority aceita "" ou "important", sem distinção entre maiúsculas e minúsculas. Não coloque !important em value. Num bloco de declarações modificável, um valor vazio remove a declaração antes de se verificar a prioridade, mesmo que esta seja inválida. Se o valor não estiver vazio, uma prioridade inválida não provoca alterações.

As propriedades não suportadas e os valores inválidos não provocam alterações. Um bloco só de leitura lança NoModificationAllowedError. O método devolve undefined.

Exemplos

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

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