Método CSSStyleDeclaration setProperty()

Objeto CSSStyleDeclaration

Definição e uso

setProperty() O método define um novo atributo CSS dentro do bloco de declaração CSS ou modifica um atributo existente.

Exemplo

Exemplo 1

Definir um novo atributo CSS:

var declaration = document.styleSheets[0].cssRules[0].style;
var setprop = declaration.setProperty("background-color", "yellow");

Experimente pessoalmente

Exemplo 2

Definir um novo atributo CSS com prioridade "important":

var declaration = document.styleSheets[0].cssRules[0].style;
var setprop = declaration.setProperty("background-color", "yellow", "important");

Experimente pessoalmente

Exemplo 3

Modificar o atributo CSS existente:

var declaration = document.styleSheets[0].cssRules[0].style;
var setprop = declaration.setProperty("color", "blue");

Experimente pessoalmente

Sintaxe

object.setProperty(propertyname, value, priority)

Parâmetro

Parâmetro Descrição
propertyname Obrigatório. Stringa, que representa o nome do atributo a ser configurado.
value Opcional. String que representa o novo valor.
priority

Opcional. String que indica se a prioridade do atributo deve ser configurada como importante.

Valores válidos:

  • "important"
  • undefined
  • ""

Detalhes técnicos

Versão DOM: Modelo de Objeto CSS
Retorno: undefined

Suporte ao navegador

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
Suporte 9.0 Suporte Suporte Suporte
Objeto CSSStyleDeclaration