CSSStyleDeclaration.setProperty()

这篇翻译不完整。请帮忙从英语翻译这篇文章

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

语法

style.setProperty(propertyName, value, priority);

参数

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

返回值

例外

  • DOMException (不允许更改错误): 如果属性或装饰块为只读的.

JavaScript 拥有为一个DOM对象简单设置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';

  说明

描述 状态 注释
CSS Object Model (CSSOM)
CSSStyleDeclaration.setProperty()
工作草案  
Document Object Model (DOM) Level 2 Style Specification
CSSStyleDeclaration
被废弃  

浏览器兼容

兼容性表

特性 Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
基础支持 (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)
特性 Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
基础支持 (Yes) (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

文档标签和贡献者

 此页面的贡献者: meiseayoung
 最后编辑者: meiseayoung,