CSSStyleDeclaration.setProperty()

CSSStyleDeclaration.setProperty() 方法接口为一个声明了CSS样式的对象设置一个新的值 。

语法

style.setProperty(propertyName, value, priority);

参数

• propertyName 是一个 DOMString ，代表被更改的CSS属性。
• value可选 是一个 DOMString ，含有新的属性值。如果没有指定, 则当作空字符串。
  • 注意: value 不能包含 "!important" --那个应该使用 priority 参数.
• priority可选 是一个 DOMString 允许设置 "important" CSS 优先级。如果没有指定, 则当作空字符串。

返回值

• undefined

异常

• DOMException (NoModificationAllowedError)： 如果属性或装饰块为只读的，抛出此异常。

JavaScript 有一个特别的，更简单的在 CSSStyleDeclaration 对象上设置CSS属性值的语法：

style.cssPropertyName = 'value';

示例

下面的Javascript代码为一个选中元素样式的 margin 属性设置一个新的值:

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

  说明

浏览器兼容

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!