当前位置：首页 > 文章列表 > 文章 > 前端 > JavaScript自定义元素开发指南

JavaScript自定义元素开发指南

2025-12-25 13:58:34 0浏览收藏

大家好，我们又见面了啊~本文《JavaScript自定义元素开发教程》的内容中将会涉及到等等。如果你正在学习文章相关知识，欢迎关注我，以后会给大家带来更多文章相关文章，希望我们能一起进步！下面就开始本文的正式内容~

自定义元素是Web Components核心功能，通过继承HTMLElement并使用customElements.define()注册，可创建可复用、封装性强的自定义标签；需注意标签名含连字符、确保定义后再使用，并推荐Shadow DOM隔离样式，还支持属性监听与原生元素扩展，提升组件化开发效率。

JavaScript自定义元素开发

自定义元素是 Web Components 的核心功能之一，允许开发者通过 JavaScript 定义自己的 HTML 标签。使用自定义元素可以封装可复用的组件，提升代码组织性与可维护性。在 JavaScript 中创建自定义元素主要依赖于 CustomElementRegistry 接口，通过 customElements.define() 方法注册新元素。

定义自定义元素的基本步骤

要创建一个自定义元素，需要继承 HTMLElement 基类，并在其中添加所需的行为和结构。

以下是基本流程：

创建一个类并继承 HTMLElement
在构造函数中调用 super()，这是必须的
可选：使用 Shadow DOM 封装内部结构与样式
通过 customElements.define() 注册元素，标签名必须包含连字符（-）

示例代码：

class MyCard extends HTMLElement {
  constructor() {
    super();
    // 创建 Shadow DOM 来隔离样式和结构
    this.attachShadow({ mode: 'open' });
    this.shadowRoot.innerHTML = `
      
      
         
      
    `;
  }
}
// 注册自定义元素
customElements.define('my-card', MyCard);

使用方式：

这是一张自定义卡片

支持属性与响应式更新

为了让自定义元素对属性变化做出反应，可以利用静态 getter observedAttributes 和 attributeChangedCallback 方法。

实现方式如下：

在类中定义 static get observedAttributes() 返回需监听的属性数组
实现 attributeChangedCallback(name, oldVal, newVal) 处理变更逻辑
可结合 connectedCallback 在元素插入 DOM 时初始化状态

示例：支持 title 属性

class MyCard extends HTMLElement {
  static get observedAttributes() {
    return ['title'];
  }
constructor() {
super();
this.attachShadow({ mode: 'open' });
}
connectedCallback() {
this.render();
}
attributeChangedCallback(name, oldVal, newVal) {
if (name === 'title') {
this.render();
}
}
render() {
const title = this.getAttribute('title') || '默认标题';
this.shadowRoot.innerHTML =  <style> .card { border: 1px solid #ddd; padding: 16px; margin: 8px; border-radius: 8px; background: #f9f9f9; } h3 { margin-top: 0; color: #333; } </style> <div class="card"> <h3>${title}</h3> <slot></slot> </div> ;
}
}
customElements.define('my-card', MyCard);

使用：

用户名：Alice

内建元素扩展（增强原生标签）

除了创建全新标签，还可以扩展原生 HTML 元素，比如增强按钮或输入框。

方法是：

继承对应元素的接口，如 HTMLButtonElement
注册时传入第三个参数 { extends: 'button' }
使用时通过 is 属性指定行为

示例：扩展 button

class FancyButton extends HTMLButtonElement {
  constructor() {
    super();
    this.addEventListener('click', () => {
      alert('点击了炫酷按钮！');
    });
  }
}
customElements.define('fancy-button', FancyButton, { extends: 'button' });

使用：

这种方式保持语义化的同时增加功能。