浏览器与 Web API / 系统课时
Shadow DOM 基础
Shadow DOM 基础
Shadow DOM 为组件创建独立的内部 DOM 树,使内部结构和样式不必直接暴露给页面。本课将创建开放式 Shadow Root,通过 slot 接收外部内容,并用事件路径验证边界外看到的目标为何会被重定向为宿主元素。
学习目标
- 创建
mode: "open"的 Shadow Root,并从宿主外部访问它。 - 使用
slot将 Light DOM 内容投影到组件内部。 - 解释样式隔离、事件
composed与目标重定向的关系。
组成与隔离边界
宿主元素存在于普通文档树中,attachShadow() 会在宿主下建立 Shadow Root。内部模板、样式和节点属于 Shadow Tree;宿主原有的子节点仍属于 Light DOM,只是通过同名 slot 显示在指定位置,并没有被移动进 Shadow Tree。
Shadow DOM 的样式作用域以边界为界。内部选择器不会匹配页面外部元素,页面普通选择器也不能直接进入 Shadow Tree。组件可用 :host 设置宿主,用 ::slotted() 为被投影的 Light DOM 顶层节点提供有限样式。

创建开放式 Shadow Root
下面定义一个 user-card 自定义元素。内部按钮样式只作用于 Shadow Tree,页面外部按钮不受影响;三个插槽分别接收头像、标题和默认内容。由于模式为 open,外部代码可以通过 card.shadowRoot 读取内部节点。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>Shadow DOM 示例</title>
<style>
body { font: 16px/1.6 sans-serif; max-width: 720px; margin: 40px auto; }
body > button { margin-top: 16px; padding: 8px 12px; }
#log { padding: 12px; background: #f4f6f8; }
</style>
</head>
<body>
<user-card id="card">
<span slot="avatar" aria-label="头像">👩💻</span>
<strong slot="title">前端工程师</strong>
<p>这段简介来自宿主的 Light DOM。</p>
</user-card>
<button id="inspect">从外部读取 open Shadow Root</button>
<pre id="log">等待操作</pre>
<script>
class UserCard extends HTMLElement {
constructor() {
super();
const root = this.attachShadow({ mode: "open" });
root.innerHTML = `
<style>
:host { display: block; border: 1px solid #ccd6e0; border-radius: 10px; padding: 16px; }
.card { display: grid; grid-template-columns: 48px 1fr; gap: 12px; }
::slotted([slot="avatar"]) { font-size: 32px; }
button { background: #1456a0; color: white; border: 0; padding: 8px 12px; }
</style>
<article class="card">
<slot name="avatar"></slot>
<section>
<h2><slot name="title">未命名用户</slot></h2>
<slot></slot>
<button id="follow">关注</button>
<span id="status"></span>
</section>
</article>`;
root.querySelector("#follow").addEventListener("click", () => {
root.querySelector("#status").textContent = " 已关注";
});
}
}
customElements.define("user-card", UserCard);
const card = document.querySelector("#card");
const log = document.querySelector("#log");
document.querySelector("#inspect").addEventListener("click", () => {
const text = card.shadowRoot.querySelector("#follow").textContent;
log.textContent = `Shadow Root 可访问,内部按钮文字:${text}`;
});
document.addEventListener("click", event => {
const origin = event.composedPath()[0];
if (origin instanceof HTMLElement && origin.id === "follow") {
log.textContent = `document 看到的 target:${event.target.tagName}
composedPath 起点:${origin.tagName}#${origin.id}`;
}
});
</script>
</body>
</html>预期结果
组件显示插槽提供的头像、标题和简介,内部“关注”按钮为蓝色,外部按钮不受该样式影响。
点击“关注”后状态变为“已关注”;document 看到的 target 是 USER-CARD,而 composedPath 起点是 BUTTON#follow。
点击外部检查按钮,可通过 card.shadowRoot 读取内部按钮文字。插槽与事件重定向
slot 只负责渲染分发。外部节点仍可通过宿主的 children 查询,内部 slot 可用 assignedElements() 查看当前分配结果。若没有匹配的 Light DOM 节点,插槽标签中的后备内容才会显示。
常见鼠标和键盘事件通常会冒泡并跨越 Shadow DOM 边界。事件离开边界后,外部监听器中的 event.target 会被重定向为宿主,从而隐藏内部实现;event.composedPath() 仍可用于检查实际传播路径。自定义事件若要跨出边界,需要同时设置 bubbles: true 与 composed: true。
开放模式只表示外部能通过 shadowRoot 访问内部树,并不等于安全隔离。不要把密钥、授权判断或不可篡改状态放入 Shadow DOM;它解决的是组件封装和样式作用域问题,而不是权限控制。