CSSStyleSheet: replaceSync() 方法

Baseline 已广泛支持

此功能已成熟,并可在许多设备和浏览器版本上运行。自 2023 年 3 月以来,它已在各种浏览器中可用。

replaceSync() 方法是 CSSStyleSheet 接口的一部分,它同步地将样式表的内容替换为传入的内容。

replaceSync()CSSStyleSheet.replace() 方法只能用于通过 CSSStyleSheet() 构造函数创建的样式表。

语法

js
replaceSync(text)

参数

文本

一个包含要替换样式表内容的样式规则的字符串。如果字符串不包含可解析的规则列表,则该值将被设置为空字符串。

注意: 如果 text 中传入的任何规则是使用 @import 规则导入的外部样式表,则这些规则将被删除,并在控制台中打印警告。

返回值

无 (undefined)。

异常

NotAllowedError DOMException

如果样式表不是使用 CSSStyleSheet() 构造函数创建的,或者样式表被标记为不可修改,则会抛出该异常。

示例

在下面的示例中,创建了一个新的样式表,并使用 replaceSync 添加了两条 CSS 规则。

js
const stylesheet = new CSSStyleSheet();

stylesheet.replaceSync("body { font-size: 1.4em; } p { color: red; }");

规范

规范
CSS 对象模型 (CSSOM)
# dom-cssstylesheet-replacesync

浏览器兼容性

另见