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

Document:adoptedStyleSheets 属性

· 52CE 我爱测

Document 接口的 **`adoptedStyleSheets`** 属性用于设置文档使用的构造样式表数组。

CSSOM

Document 接口的 adoptedStyleSheets 属性用于设置文档使用的构造样式表数组。

[!NOTE] 构建样式表是指使用 CSSStyleSheet() 构造函数以编程方式创建的样式表(与用户代理在从脚本导入样式表时、使用 style 和 @import 进行导入,或通过 link)链接时创建的样式表相对比。

相同的构造样式表也可以通过使用 ShadowRoot.adoptedStyleSheets 属性与一个或多个 ShadowRoot 实例共享。更改已采用的样式表会影响采用该样式表的所有对象。

该属性中的样式表将与文档的其他样式表一起根据 CSS 层叠算法进行求值。在规则解析考虑样式表的顺序时,adoptedStyleSheets 被假定排列在 Document.styleSheets 中那些样式表之后。

只有在当前 Document 上下文中使用 CSSStyleSheet() 构造函数创建的样式表才可以被采用。

值

该值是 CSSStyleSheet 实例数组,这些实例必须是在同一 Document 上下文中使用 CSSStyleSheet.CSSStyleSheet() 构造函数创建的。

如果需要修改数组,可以使用像 push() 这样的原地修改方法。CSSStyleSheet 实例本身也可以被修改,且这些修改将应用在采用该样式表的任何地方。

在早期版本规范中,该数组是不可修改的,因此添加新样式表的唯一方法是为 adoptedStyleSheets 分配一个新的数组。

异常

  • NotAllowedError DOMException
    • : 数组中的某个 CSSStyleSheet 实例不是使用 CSSStyleSheet() 构造函数创建的,或者是与当前文档不同的文档(例如 iframe 中的文档)中构建的。

示例

采用样式表

以下代码展示了样式表的构建过程,然后调用 CSSStyleSheet.replaceSync() 将一条规则添加到样式表中。然后样式表会被添加到数组中,并分配给 adoptedStyleSheets 属性。

// 创建一个空的“构造的”样式表
const sheet = new CSSStyleSheet();
// 应用一条规则到样式表
sheet.replaceSync("a { color: red; }");

// 将样式表应用到文档中
document.adoptedStyleSheets = [sheet];

我们可以使用 CSSStyleSheet.insertRule() 将新规则添加到样式表中。

sheet.insertRule("* { background-color: blue; }");
// 现在文档将显示蓝色背景。

追加新的样式表

要在 adoptedStyleSheets 属性中添加全新的样式表,我们必须创建新的组合数组并为其赋值。下面将使用展开语法进行展示:

const extraSheet = new CSSStyleSheet();
extraSheet.replaceSync("p { color: green; }");

// 合并现有样式表和新的样式表
document.adoptedStyleSheets = [...document.adoptedStyleSheets, extraSheet];

与影子 DOM 共享样式表

我们可以用类似的方法将样式表共享到影子根中。

// 在文档中创建元素,然后创建影子根:
const node = document.createElement("div");
const shadow = node.attachShadow({ mode: "open" });

// 在影子 DOM 中采用同一个样式表
shadow.adoptedStyleSheets = [sheet];

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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