CSSStyleSheet: replaceSync() 方法

基线 2023

新功能

自 2023 年 3 月起，此功能可在最新的设备和浏览器版本中使用。此功能可能无法在较旧的设备或浏览器中使用。

replaceSync() 方法是 CSSStyleSheet 接口的方法，它会同步地将样式表的內容替换为传入的內容。

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

replaceSync(text)

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

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

无 (undefined)。

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

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

const stylesheet = new CSSStyleSheet();

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

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

BCD 表格仅在启用了 JavaScript 的浏览器中加载。