Shadow DOM 是 Web 组件的核心技术，它通过创建隔离的 DOM 树实现样式和结构的封装，防止外部 CSS 影响内部元素且内部样式不泄露。1. 使用 attachShadow({ mode: 'open' }) 在自定义元素中挂载 Shadow DOM；2. 通过 shadowRoot.innerHTML 动态插入 HTML 和样式；3. 利用 customElements.define() 注册组件标签；4. 可动态更新内容并处理事件，通过 composed: true 使事件跨越 Shadow 边界。该机制适合构建可复用、高内聚的 UI 组件，提升模块化与维护性。
在现代前端开发中，Web组件提供了一种构建可复用、独立封装UI组件的方式。其中，Shadow DOM 是 Web 组件的核心技术之一，它允许将一个隔离的 DOM 树附加到元素上，从而实现样式和结构的封装。结合 JavaScript 动态生成 HTML 内容，可以创建高度模块化、不被外部样式干扰的组件。
什么是 Shadow DOM？
Shadow DOM 创建了一个与主文档 DOM 隔离的“影子”树。这个树中的元素不会受到页面其他 CSS 的影响，同时其内部样式也不会泄露出去。这种封装性非常适合构建可复用的 UI 组件。
通过 JavaScript 可以轻松创建并管理 Shadow DOM，并在其内部动态插入 HTML 结构。
创建带 Shadow DOM 的自定义元素
使用 customElements.define() 方法注册一个自定义标签，并在其构造函数中挂载 Shadow DOM。
立即学习“前端免费学习笔记（深入）”；
示例：创建一个显示欢迎消息的组件
class WelcomeCard extends HTMLElement {
constructor() {
super();
// 创建 Shadow DOM
this.attachShadow({ mode: 'open' });
// 获取属性值
const name = this.getAttribute('name') || 'Guest';
// 构建内部 HTML
this.shadowRoot.innerHTML = `
<style>
.card {
border: 1px solid #ddd;
border-radius: 8px;
padding: 16px;
font-family: Arial, sans-serif;
background-color: #f9f9f9;
}
h2 {
color: #333;
}
</style>
<div class="card">
<h2>Welcome, ${name}!</h2>
<p>This content is inside Shadow DOM.</p>
</div>
`;
}
}
// 注册自定义元素
customElements.define('welcome-card', WelcomeCard);
之后可在 HTML 中直接使用：
<welcome-card name="Alice"></welcome-card>
动态更新 Shadow DOM 内容
除了初始化渲染，还可以通过 JS 监听属性变化或响应用户操作来更新 Shadow DOM 中的内容。
例如，添加一个方法用于更新名字：
// 在 WelcomeCard 类中添加方法
updateName(newName) {
const h2 = this.shadowRoot.querySelector('h2');
if (h2) {
h2.textContent = `Welcome, ${newName}!`;
}
}
然后在外部调用：
const card = document.querySelector('welcome-card');
card.updateName('Bob');
事件处理与通信
由于 Shadow DOM 是隔离的，事件默认会冒泡到主 DOM，但可以通过 Event.composed 控制是否跨越 Shadow 边界。
比如为按钮添加点击事件：
this.shadowRoot.innerHTML = `
<button id="clickMe">Click me</button>
`;
this.shadowRoot.getElementById('clickMe')
.addEventListener('click', () => {
this.dispatchEvent(new CustomEvent('greet', {
bubbles: true,
composed: true,
detail: { message: 'Hello from Shadow DOM!' }
}));
});
在父页面监听：
document.addEventListener('greet', (e) => {
console.log(e.detail.message);
});
基本上就这些。利用 JavaScript 操作 Shadow DOM，既能保证组件的独立性，又能实现丰富的交互逻辑。这种方式特别适合构建设计系统、表单控件或嵌入式小工具，避免样式冲突的同时提升代码可维护性。不复杂但容易忽略的是细节控制，比如 mode 设置为 closed 虽更封闭但调试困难，一般推荐 open 模式。
