当前位置：首页 > 文章列表 > 文章 > 前端 > JavaScriptWeb组件：CustomElements与ShadowDOM解析

JavaScriptWeb组件：CustomElements与ShadowDOM解析

2026-01-06 17:02:38 0浏览收藏

来到golang学习网的大家，相信都是编程学习爱好者，希望在这里学习文章相关编程知识。下面本篇文章就来带大家聊聊《JavaScript Web组件：Custom Elements与Shadow DOM详解》，介绍一下，希望对大家的知识积累有所帮助，助力实战开发！

Web组件通过Custom Elements和Shadow DOM实现可重用、样式隔离的自定义元素。1. Custom Elements允许创建带JavaScript类的自定义HTML标签，使用customElements.define()注册，标签名需含短横线；2. Shadow DOM提供隔离DOM树，通过attachShadow({mode: 'open'})创建，确保内部CSS与外部互不干扰；3. 两者结合可构建高度封装的独立组件，适用于设计系统、嵌入式小工具等场景，且需注意事件重定向和选择器作用域问题。

JavaScriptWeb组件_CustomElements与ShadowDOM

Web组件是一组浏览器原生支持的API，允许你创建可重用、封装良好的自定义HTML元素。其中，Custom Elements 和 Shadow DOM 是两个核心部分。它们让你能在不依赖框架的前提下构建独立、样式隔离、行为清晰的组件。

Custom Elements：定义自己的HTML标签

Custom Elements 允许你创建新的HTML标签，并为其绑定JavaScript类。你可以控制元素的生命周期，比如何时被添加或移除。

使用 customElements.define() 方法注册一个自定义元素。标签名必须包含短横线（-），这是为了避免和未来HTML标准冲突。

示例：创建一个简单的问候组件

class GreetingElement extends HTMLElement {
  constructor() {
    super();
    const name = this.getAttribute('name') || 'Guest';
    this.innerHTML = `Hello, ${name}!`;
  }
}
customElements.define('my-greeting', GreetingElement);

之后就可以在HTML中使用：

Shadow DOM：实现样式与结构的封装

Shadow DOM 提供了一个隔离的DOM树，它挂载在元素上但与主文档DOM分离。这意味着组件内部的CSS不会影响外部页面，外部样式也不会“泄漏”进组件。

通过 this.attachShadow({ mode: 'open' }) 创建Shadow DOM。mode 可为 'open'（可在JS中访问）或 'closed'（不可访问）。

改进上面的例子，加入Shadow DOM：

class GreetingElement extends HTMLElement {
  constructor() {
    super();
    const shadow = this.attachShadow({ mode: 'open' });
    const name = this.getAttribute('name') || 'Guest';

    // 组件内部结构
    const wrapper = document.createElement('div');
    wrapper.innerHTML = `Hello, ${name}!`;

    // 添加样式
    const style = document.createElement('style');
    style.textContent = `
      p { color: blue; font-family: sans-serif; }
    `;

    shadow.appendChild(style);
    shadow.appendChild(wrapper);
  }
}
customElements.define('my-greeting', GreetingElement);

此时，组件内的蓝色文字样式不会影响页面其他

标签。