javascript Web组件是什么_如何创建自定义HTML元素？

夢幻星辰 2025-12-15 00:00:00 次阅读

JavaScript Web组件是浏览器原生API，用于创建可复用、封装良好的自定义HTML元素，基于Custom Elements、Shadow DOM和HTML Templates标准，无需依赖React或Vue等框架。

JavaScript Web组件是一套浏览器原生支持的API，用来创建可复用、封装良好的自定义HTML元素。它不是框架，不依赖React或Vue，而是基于标准（Custom Elements、Shadow DOM、HTML Templates），让开发者能像用或一样直接使用或这类自定义标签。

什么是自定义元素（Custom Element）

自定义元素是Web Components的核心之一，指通过customElements.define()注册的、带连字符（-）的HTML标签名（如user-card）。浏览器会识别它为合法元素，并允许你控制它的结构、样式和行为。

关键规则：

名字必须包含短横线（-），不能是单个单词（mydiv非法，my-div合法）
不能与现有HTML标签重名（如div、article）
必须继承HTMLElement或其子类（如HTMLButtonElement）

如何定义一个基础自定义元素

最简步骤：声明类 → 定义元素 → 使用标签。例如做一个显示欢迎语的：

class HelloWorld extends HTMLElement {
  connectedCallback() {
    this.innerHTML = `Hello, ${this.getAttribute('name') || 'World'}!`;
  }
}
customElements.define('hello-world', HelloWorld);

然后在HTML中直接写：，页面就会渲染出“Hello, Alice!”。

常用生命周期回调：

connectedCallback：元素插入DOM时触发（适合初始化）
disconnectedCallback：从DOM移除时触发（适合清理定时器、事件监听）
attributeChangedCallback：监听属性变化（需配合observedAttributes静态属性）
adoptedCallback：元素被移动到新document时触发（少见）

用Shadow DOM封装样式和结构

避免样式污染和结构干扰，推荐在connectedCallback中附加Shadow DOM：

class AlertBox extends HTMLElement {
  constructor() {
    super();
    const shadow = this.attachShadow({ mode: 'open' });
    shadow.innerHTML = `
      
      
    `;
  }
}
customElements.define('alert-box', AlertBox);

用于内容分发——把外部写的文字（如系统错误）投射进Shadow内部。

注意：mode: 'open'表示可通过element.shadowRoot访问；设为'closed'则无法从外部JS读取Shadow内容（更封闭，但调试不便）。