Web Components 是基于标准 Web API 的原生组件化技术,由 Custom Elements、Shadow DOM 和 HTML Templates 三大技术构成,支持创建可复用、样式隔离的自定义元素;通过 customElements.define() 定义标签,attachShadow() 创建影子根实现封装,结合 与 构建结构;示例中 MyCard 组件在 HTML 中以 使用,具备独立样式与 DOM 隔离;其优势在于原生性、跨框架兼容、无依赖、高可维护性,适用于设计系统与微前端;主流浏览器已广泛支持,旧版可通过 polyfill 兼容,未来在跨平台共享中潜力显著。

Web Components 是一套浏览器原生支持的组件化开发技术,它让开发者可以创建可复用、封装良好且不依赖框架的自定义 HTML 元素。与 React、Vue 等框架的组件不同,Web Components 基于标准 Web API,无需额外库即可在现代浏览器中运行。掌握其核心机制,有助于理解前端组件化的底层逻辑。
核心构成:三大技术支柱
Web Components 由三个主要技术组成,它们共同实现组件的定义与封装:
-
Custom Elements:允许开发者定义新的 HTML 标签。通过 customElements.define() 方法注册类与标签名的映射,例如定义一个
元素。 - Shadow DOM:为组件提供独立的 DOM 和样式作用域。通过 element.attachShadow() 创建影子根节点,内部结构和样式不会被外部影响,实现真正的封装。
-
HTML Templates:使用
和预定义组件的结构。模板内容在页面加载时不渲染,直到被 JavaScript 实例化插入。
实际开发中的使用方式
一个典型的 Web Component 可以这样编写:
class MyCard extends HTMLElement {
constructor() {
super();
this.attachShadow({ mode: 'open' });
this.shadowRoot.innerHTML = `
`;
}
}
customElements.define('my-card', MyCard);
之后即可在 HTML 中直接使用:。组件内部样式隔离,外部无法直接访问其 DOM 结构。
优势与适用场景
Web Components 的最大优势在于原生性和跨框架兼容性。它可以被 React、Vue、Angular 等任意框架引用,适合构建设计系统、通用 UI 库或微前端中的独立模块。
- 无需依赖框架,提升长期可维护性。
- 样式和逻辑完全封装,避免全局污染。
- 支持语义化标签,增强代码可读性。
但在事件通信、状态管理等方面需自行设计方案,复杂应用中可能需要结合其他工具补充能力。
浏览器支持与未来发展
主流现代浏览器均已完整支持 Web Components 标准。对于旧版浏览器(如 IE),可通过 polyfill 方案兼容。随着 Web 标准推进,越来越多的库(如 Lit)基于 Web Components 提供更简洁的开发体验,未来在跨平台组件共享方面潜力巨大。
基本上就这些。Web Components 不复杂但容易忽略细节,比如影子树的样式穿透控制、自定义元素的生命周期回调等,深入使用时值得逐一掌握。










