JavaScriptWeb组件_CustomElements与ShadowDOM-js教程-PHP中文网

JavaScriptWeb组件_CustomElements与ShadowDOM

紅蓮之龍

发布： 2025-11-26 16:48:07

原创

111人浏览过

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标准冲突。

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

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

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

登录后复制

之后就可以在HTML中使用：

<my-greeting name="Alice"></my-greeting>

登录后复制

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

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

小艺

华为公司推出的AI智能助手

549

查看详情

通过 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 = `<p>Hello, ${name}!</p>`;

    // 添加样式
    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);

登录后复制

此时，组件内的蓝色文字样式不会影响页面其他 <p> 标签。