HTML5 的 Custom Elements 是 Web Components 技术的一部分，它允许开发者定义自己的 HTML 标签，实现真正的组件化开发。通过这种方式，可以创建可复用、封装良好且语义清晰的自定义元素，提升代码组织结构和开发效率。
什么是 Custom Elements
Custom Elements 是 HTML5 提供的一项能力，让开发者能够扩展 HTML 标准，定义新的标签名称并赋予其特定行为。这些自定义标签本质上是 JavaScript 类，继承自 HTMLElement，并通过 customElements.define() 方法注册到浏览器中。
例如，你可以创建一个名为 <my-card> 的卡片组件，或一个 <user-avatar> 显示用户头像的标签，使 HTML 更具语义化和可读性。
如何定义一个自定义元素
定义一个自定义元素需要以下步骤：
立即学习“前端免费学习笔记（深入）”；
- 编写一个继承自 HTMLElement 的类，添加所需逻辑
- 在类中使用 constructor() 初始化元素（必须调用 super()）
- 通过 customElements.define() 注册标签名
示例代码：
class MyCard extends HTMLElement {
constructor() {
super();
const shadow = this.attachShadow({ mode: 'open' });
shadow.innerHTML = `
<style>
.card {
border: 1px solid #ddd;
padding: 16px;
border-radius: 8px;
font-family: sans-serif;
}
</style>
<div class="card">
<h3><slot name="title">默认标题</slot></h3>
<p><slot>这里是内容</slot></p>
</div>
`;
}
}
customElements.define('my-card', MyCard);
使用方式：
<my-card> <span slot="title">欢迎卡</span> 这是一段自定义内容。 </my-card>
结合 Shadow DOM 实现组件封装
Custom Elements 常与 Shadow DOM 配合使用，实现样式和结构的隔离。上面的例子中通过 this.attachShadow() 创建了影子根，确保组件内部样式不会影响外部页面，也防止外部样式污染组件。
这种封装机制是组件化开发的核心优势之一 —— 每个组件独立运作，可跨项目复用，降低耦合度。
组件化开发的实际意义
使用 Custom Elements 开发，相当于构建一套属于团队或项目的 UI 组件库。比如：
- 统一的按钮组件：<app-button type="primary">
- 数据展示组件：<data-table>
- 表单控件：<input-date>
这类组件可以在不同页面甚至不同项目中直接导入使用，无需重复开发。配合现代构建工具（如 Vite、Webpack），还可以实现按需加载和类型检查。
基本上就这些。Custom Elements 让原生 HTML 具备了组件化能力，不依赖框架也能写出结构清晰、维护性强的前端代码。虽然目前复杂交互场景仍多由 React、Vue 等框架主导，但原生组件化正逐渐成为补充甚至替代方案，尤其适合轻量级项目或设计系统建设。
