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.