JavaScript影子DOM_封装组件技术-js教程-PHP中文网

JavaScript影子DOM_封装组件技术

幻影之瞳

发布： 2025-11-27 12:13:02

原创

145人浏览过

影子DOM是Web Components标准的一部分，通过attachShadow方法为元素挂载独立DOM树，实现样式与结构的隔离；其内部CSS仅作用于影子根内，支持slot内容分发和::part()样式定制；常与自定义元素结合，用于构建高封装性的可复用组件，适用于设计系统、微前端等需避免样式冲突的场景。

javascript影子dom_封装组件技术

影子DOM（Shadow DOM）是JavaScript中用于构建封装组件的核心技术之一。它允许开发者将一个独立的DOM树附加到某个元素上，并与主文档的DOM隔离，从而实现样式和结构的封装。这种隔离特性让组件内部的HTML、CSS不会受到外部影响，也避免了全局污染，特别适合开发可复用的UI组件。

什么是影子DOM

影子DOM是一种浏览器原生支持的技术，属于Web Components标准的一部分。它可以在普通DOM元素内部创建一个“影子根”，这个根节点下可以包含独立的DOM结构和样式。

通过Element.attachShadow()方法，你可以为任意元素挂载一个影子根：

使用{ mode: 'open' }时，可以通过JavaScript在外部访问影子根
使用{ mode: 'closed' }时，影子根无法被外部脚本访问，增强封装性

示例：

const div = document.createElement('div');
const shadowRoot = div.attachShadow({ mode: 'open' });
shadowRoot.innerHTML = '<style>p { color: red; }</style><p>这是影子DOM内容</p>';
document.body.appendChild(div);

登录后复制

样式与结构的隔离

影子DOM最大的优势在于其封装能力。内部样式默认不会泄露出去，外部样式也不会轻易影响内部元素。

立即学习“Java免费学习笔记（深入）”；

在影子根中定义的CSS只作用于内部元素，即使选择器为p也不会影响页面其他<p>
可通过::part()和::slotted()机制暴露部分样式接口，供外部定制
slot元素可用于插入外部内容，实现内容分发，提升组件灵活性

例如：

shadowRoot.innerHTML = `
  <slot name="title"></slot>
  <slot>默认内容</slot>
`;

登录后复制

然后在外部使用：

<my-component>
  <span slot="title">标题</span>
  <p>填充默认插槽</p>
</my-component>

登录后复制

结合自定义元素使用

影子DOM常与Custom Elements搭配使用，构建完整的自定义组件。

Typewise.app

面向客户服务和销售团队的AI写作解决方案。

查看详情

通过继承HTMLElement并在构造函数中挂载影子根，可以创建高度封装的HTML标签。

定义类并调用this.attachShadow({ mode: 'open' })
在类中添加事件监听、属性响应逻辑
使用customElements.define()注册新标签名

示例：

class MyCard extends HTMLElement {
  constructor() {
    super();
    this.attachShadow({ mode: 'open' });
    this.shadowRoot.innerHTML = `
      <style>.card { border: 1px solid #ccc; padding: 1em; }</style>
      <div class="card">
        <slot></slot>
      </div>
    `;
  }
}
customElements.define('my-card', MyCard);

登录后复制

之后即可使用：<my-card>我是卡片内容</my-card>