CSSStyleDeclaration.setProperty()

语法

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';

规范

浏览器兼容性