浏览器与 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 DOM 结构、插槽与事件重定向关系

创建开放式 Shadow Root

下面定义一个 user-card 自定义元素。内部按钮样式只作用于 Shadow Tree,页面外部按钮不受影响;三个插槽分别接收头像、标题和默认内容。由于模式为 open,外部代码可以通过 card.shadowRoot 读取内部节点。

html
<!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>

预期结果

text
组件显示插槽提供的头像、标题和简介,内部“关注”按钮为蓝色,外部按钮不受该样式影响。
点击“关注”后状态变为“已关注”;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;它解决的是组件封装和样式作用域问题,而不是权限控制。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Shadow DOM 基础

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通