大网数据广告活动
Web 标准与前端开发

CSSStyleDeclaration.setProperty()

· 52CE 我爱测

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

CSSOM

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

语法

style.setProperty(propertyName, value, priority);

参数

  • propertyName 是一个 String ,代表被更改的 CSS 属性。

  • value 是一个 String ,含有新的属性值。如果没有指定,则当作空字符串。

    • 注意:value 不能包含 "!important" --那个应该使用 priority 参数。
  • priority 是一个 String 允许设置 "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';

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。