CSSStyleDeclaration.setProperty

The CSSStyleDeclaration.setProperty() method interface sets a new value for a property on a CSS style declaration object.

Syntax

style.setProperty(propertyName, value, priority);

Parameters

• propertyName is a DOMString representing the CSS property name (hyphen case) to be modified.
• value Optional is a DOMString containing the new property value. If not specified, treated as the empty string.
  • Note: value must not contain "!important" -- that should be set using the priority parameter.
• priority Optional is a DOMString allowing the "important" CSS priority to be set. If not specified, treated as the empty string. The following values are accepted:
  • String value "important"
  • Keyword undefined
  • String empty value ""

Return value

• undefined

Exceptions

• DOMException (NoModificationAllowedError): if the property or declaration block is read only.

JavaScript has a special simpler syntax for setting a CSS property on a style declaration object:

style.cssPropertyName = 'value';

Example

The following JavaScript code sets a new value for the border-width CSS property on a selector rule:

var declaration = document.styleSheets[0].rules[0].style;
declaration.setProperty('border-width', '1px 2px');
// Equivalent to:
// declaration.borderWidth = '1px 2px';

Specifications

Browser compatibilityUpdate compatibility data on GitHub