Shadow dom 是 Web Components 的核心技术,用于实现 DOM 封装与样式隔离。通过 attachShadow() 方法可在元素内部创建独立的 DOM 环境,其结构和样式对外不可见且互不影响。支持 open 和 closed 两种模式,分别控制外部是否可访问 Shadow Root。具备样式隔离、结构隐藏和事件重定向特性,确保组件内聚性。利用 :host 和 ::slotted() 可实现宿主与插槽的样式控制,css 变量支持穿透传递。广泛应用于自定义 ui 组件、第三方嵌入工具及设计系统中,结合 Custom Elements 构建高复用、解耦的前端组件体系。

Shadow DOM 是 Web Components 的核心技术之一,它的主要作用是实现 DOM 的封装与样式隔离。通过 Shadow DOM,开发者可以将一段独立的 DOM 树“挂载”到普通 DOM 节点上,但这段树在外部不可见、不受外部样式影响,从而实现真正的组件级封装。
什么是 Shadow DOM
Shadow DOM 允许你在某个元素内部创建一个隔离的 DOM 环境。这个环境中的 html 结构和 CSS 样式不会被页面其他部分干扰,也不会影响全局文档。
使用 attachShadow() 方法可以为一个元素创建 Shadow Root,之后就可以在这个根节点下添加自己的标记结构和样式。
例如:
const host = document.getElementById(‘host’);
const shadowRoot = host.attachShadow({ mode: ‘closed’ });
shadowRoot.innerHTML = ‘<div>这是影子DOM内容</div>’;
这里的 mode 可以是 open 或 closed,区别在于是否允许外部 javaScript 通过 element.shadowRoot 访问影子根节点。
立即学习“Java免费学习笔记(深入)”;
DOM 隔离机制详解
Shadow DOM 最大的优势是提供了真正的 DOM 封装能力,具体体现在以下几点:
- 样式隔离:在 Shadow Root 内部定义的 CSS 样式不会泄露到外部,外部的样式也不会轻易影响内部元素(除非使用继承属性)。
- 结构隐藏:Shadow Tree 中的内容在常规 DOM 遍历中不可见,提高了组件的封装性。
- 事件重定向:从 Shadow DOM 内部触发的事件,在冒泡到外部时,其目标会被重新映射为宿主元素,防止暴露内部结构。
这种隔离让组件开发者可以放心地命名类名、编写样式,而不必担心与页面其他部分发生冲突。
样式作用域与穿透控制
虽然 Shadow DOM 默认隔离样式,但也提供了一些机制来实现可控的样式交互:
- 使用 :host 伪类可以为 Shadow Root 的宿主元素设置样式。
- 通过 :host(.theme-dark) 可以根据宿主上的类动态调整内部主题。
- 使用 ::slotted() 可以为插槽(slot)中传入的内容定制样式。
- 若需外部样式影响内部,可使用 CSS 自定义属性(变量)进行透传。
例如:
:host {
display: block;
border: 1px solid #ccc;
}
::slotted(p) {
color: blue;
}
实际应用场景
Shadow DOM 特别适合用于构建可复用、高内聚的 Web 组件,比如:
- 自定义输入框、模态框、按钮等 UI 控件。
- 第三方嵌入式小工具(如广告、聊天窗口),避免与页面样式冲突。
- 设计系统或组件库,确保每个组件的行为和外观一致且独立。
结合 Custom Elements 使用,能完整实现一个真正解耦、可维护的组件体系。
基本上就这些。Shadow DOM 的封装机制虽有一定学习成本,但它是现代前端组件化的重要基石,掌握它有助于深入理解浏览器原生的组件模型。


