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

JavaScriptWeb组件详解：CustomElements与ShadowDOM

2025-12-06 20:06:51 0浏览收藏

**JavaScript Web组件：Custom Elements与Shadow DOM解析 - 构建可复用、样式隔离的Web组件** Web组件技术是现代Web开发的关键组成部分，它允许开发者创建可复用、封装良好的自定义HTML元素。本文深入解析Web组件的两大核心技术：Custom Elements 和 Shadow DOM。Custom Elements 允许你定义自己的HTML标签，通过 `customElements.define()` 注册，轻松创建带JavaScript类的自定义元素。Shadow DOM 则提供了一个隔离的DOM树，确保组件内部CSS与外部互不干扰，实现样式与结构的封装。结合两者，可以构建高度独立的UI组件，适用于设计系统、嵌入式小工具等多种场景。本文还将探讨使用Web组件的注意事项，助你掌握这项强大的技术，提升Web开发效率和代码质量。

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);

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

标签。