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











