当前位置:首页 > 文章列表 > 文章 > 前端 > JS如何玩转ShadowDOM?这6个核心知识点必看!

JS如何玩转ShadowDOM?这6个核心知识点必看!

2025-06-18 11:41:19 0浏览 收藏

掌握Shadow DOM,打造更健壮的Web组件!本文深入解析JS玩转Shadow DOM的6个核心知识点,助你轻松理解并应用这项强大的技术。Shadow DOM能将DOM结构隐藏并独立封装,有效避免全局样式污染,提升代码健壮性。文章详细讲解了如何使用`attachShadow()`创建Shadow DOM,`open`和`closed`模式的区别,以及如何向其中添加HTML和CSS内容。同时,还介绍了如何访问Shadow DOM内部元素,处理事件重定向问题,巧妙运用`slot`插槽实现外部内容插入,以及使用CSS Shadow Parts进行精细样式控制。此外,文章还阐述了Shadow DOM与Web Components的关系,并提供了性能考量与调试技巧,助力开发者全面掌握Shadow DOM,构建可复用、易维护的Web应用。

Shadow DOM是一种将DOM结构隐藏并独立封装的技术,通过attachShadow()方法创建,返回ShadowRoot对象作为根节点。使用open模式可外部访问,closed模式则不可。向Shadow DOM添加内容可通过innerHTML插入HTML与CSS,样式仅内部生效。访问元素时,open模式用shadowRoot结合querySelector操作,closed模式需预先保存引用。事件处理中,composed属性设为true可避免事件重定向。slot插槽允许外部内容插入指定位置,提升组件灵活性。CSS Shadow Parts支持从外部样式化内部元素。Shadow DOM是Web Components的重要组成部分,与Custom Elements和HTML Templates协同工作。性能上需避免过度使用,调试可用开发者工具或console.log辅助。

js如何操作Shadow DOM Shadow DOM操作的6个核心知识点

Shadow DOM,简单来说,就是把DOM结构藏起来,形成一个独立的“影子”。JS操作它,其实就是进入这个“影子”世界,然后进行各种DOM操作。

js如何操作Shadow DOM Shadow DOM操作的6个核心知识点

掌握Shadow DOM操作,能让你更好地封装组件,避免全局样式污染,提高代码的健壮性。

js如何操作Shadow DOM Shadow DOM操作的6个核心知识点

Shadow DOM操作的6个核心知识点

js如何操作Shadow DOM Shadow DOM操作的6个核心知识点

如何创建和附加Shadow DOM?

创建Shadow DOM的核心是attachShadow()方法。这个方法会返回一个ShadowRoot对象,你可以把它看作是Shadow DOM的根节点。

const element = document.querySelector('#my-element');
const shadowRoot = element.attachShadow({mode: 'open'}); // 或者 {mode: 'closed'}

mode参数有两种:openclosed

  • open:可以通过element.shadowRoot访问到Shadow DOM。
  • closed:无法从外部访问Shadow DOM,增强了封装性,但调试起来会麻烦一些。

个人建议,除非有特别强的安全需求,否则用open模式,方便调试。毕竟,调试才是程序员的日常。

如何向Shadow DOM中添加内容?

有了ShadowRoot,就可以像操作普通DOM一样,往里面添加各种元素了。

shadowRoot.innerHTML = `
  <style>
    p { color: blue; }
  </style>
  <p>This is a paragraph inside the Shadow DOM.</p>
`;

这里不仅可以添加HTML,还可以添加CSS样式。这正是Shadow DOM的强大之处,样式只在Shadow DOM内部生效,不会影响到外部。

如何访问Shadow DOM内部的元素?

如果Shadow DOM是open模式,可以通过element.shadowRoot访问到ShadowRoot对象,然后用querySelectorquerySelectorAll等方法查找元素。

const element = document.querySelector('#my-element');
const shadowRoot = element.shadowRoot;
const paragraph = shadowRoot.querySelector('p');
console.log(paragraph.textContent); // 输出: This is a paragraph inside the Shadow DOM.

如果是closed模式,就无法直接访问了。只能在创建Shadow DOM的时候,保存对内部元素的引用。

如何处理Shadow DOM的事件?

Shadow DOM的事件处理有些特殊。有些事件会被重定向(retarget),比如鼠标事件。这意味着,如果在Shadow DOM内部点击一个元素,外部监听器接收到的事件目标是宿主元素(host element),而不是Shadow DOM内部的元素。

<my-element id="my-element">
  #shadow-root
    <button id="my-button">Click me</button>
</my-element>

<script>
  const element = document.querySelector('#my-element');
  element.addEventListener('click', (event) => {
    console.log(event.target); // 输出: <my-element id="my-element"></my-element>
  });

  const shadowRoot = element.attachShadow({mode: 'open'});
  shadowRoot.innerHTML = `<button id="my-button">Click me</button>`;
</script>

如果想在外部知道点击的是Shadow DOM内部的哪个元素,可以使用composed属性。将composed设置为true,事件就不会被重定向。

如何使用slot插槽?

Slot是Shadow DOM的一个重要特性,它允许外部内容插入到Shadow DOM的指定位置。

<my-element>
  <span slot="my-slot">This is external content.</span>
</my-element>

<template id="my-element-template">
  <style>
    div { border: 1px solid red; }
  </style>
  <div>
    <slot name="my-slot">This is default content.</slot>
  </div>
</template>

<script>
  class MyElement extends HTMLElement {
    constructor() {
      super();
      const shadowRoot = this.attachShadow({mode: 'open'});
      const template = document.getElementById('my-element-template');
      shadowRoot.appendChild(template.content.cloneNode(true));
    }
  }
  customElements.define('my-element', MyElement);
</script>

在这个例子中,的内容会替换掉Shadow DOM中的。如果外部没有提供内容,就会显示默认内容“This is default content.”。

Slot让组件更加灵活,可以根据外部的需求定制显示内容。

如何使用CSS Shadow Parts?

CSS Shadow Parts允许你从外部样式化Shadow DOM内部的特定元素。

<my-element>
  #shadow-root
    <button part="my-button">Click me</button>
</my-element>

<style>
  my-element::part(my-button) {
    background-color: yellow;
    color: black;
  }
</style>

<script>
  class MyElement extends HTMLElement {
    constructor() {
      super();
      const shadowRoot = this.attachShadow({mode: 'open'});
      shadowRoot.innerHTML = `<button part="my-button">Click me</button>`;
    }
  }
  customElements.define('my-element', MyElement);
</script>

在这个例子中,my-element::part(my-button)选择器会选中Shadow DOM内部的

MySQL中as怎么使用的?手把手教你搞定查询别名MySQL中as怎么使用的?手把手教你搞定查询别名
上一篇
MySQL中as怎么使用的?手把手教你搞定查询别名
PHP函数节流技巧分享,轻松控制函数执行频率
下一篇
PHP函数节流技巧分享,轻松控制函数执行频率
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    499次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    484次学习
查看更多
AI推荐
  • PandaWiki开源知识库:AI大模型驱动,智能文档与AI创作、问答、搜索一体化平台
    PandaWiki开源知识库
    PandaWiki是一款AI大模型驱动的开源知识库搭建系统,助您快速构建产品/技术文档、FAQ、博客。提供AI创作、问答、搜索能力,支持富文本编辑、多格式导出,并可轻松集成与多来源内容导入。
    125次使用
  • SEO  AI Mermaid 流程图:自然语言生成,文本驱动可视化创作
    AI Mermaid流程图
    SEO AI Mermaid 流程图工具:基于 Mermaid 语法,AI 辅助,自然语言生成流程图,提升可视化创作效率,适用于开发者、产品经理、教育工作者。
    922次使用
  • 搜获客笔记生成器:小红书医美爆款内容AI创作神器
    搜获客【笔记生成器】
    搜获客笔记生成器,国内首个聚焦小红书医美垂类的AI文案工具。1500万爆款文案库,行业专属算法,助您高效创作合规、引流的医美笔记,提升运营效率,引爆小红书流量!
    944次使用
  • iTerms:一站式法律AI工作台,智能合同审查起草与法律问答专家
    iTerms
    iTerms是一款专业的一站式法律AI工作台,提供AI合同审查、AI合同起草及AI法律问答服务。通过智能问答、深度思考与联网检索,助您高效检索法律法规与司法判例,告别传统模板,实现合同一键起草与在线编辑,大幅提升法律事务处理效率。
    958次使用
  • TokenPony:AI大模型API聚合平台,一站式接入,高效稳定高性价比
    TokenPony
    TokenPony是讯盟科技旗下的AI大模型聚合API平台。通过统一接口接入DeepSeek、Kimi、Qwen等主流模型,支持1024K超长上下文,实现零配置、免部署、极速响应与高性价比的AI应用开发,助力专业用户轻松构建智能服务。
    1026次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码