Web Components通过Custom Elements、Shadow dom和html Templates实现跨框架复用。Custom Elements创建自定义标签,Shadow DOM隔离样式与结构,HTML Templates预定义内容并延迟渲染。结合connectedCallback和attributeChangedCallback可管理生命周期与响应属性变化,使用<slot>支持内容分发。组件可在react、vue或纯HTML中直接使用,也可封装为npm包或cdn资源,实现设计系统统一与长期维护。

用 Web Components 做可复用组件,核心是利用浏览器原生能力,不靠框架也能实现高内聚、低耦合的 ui 模块。它真正做到了一次开发,能在 React、Vue 甚至纯 HTML 项目里直接用。
三大核心技术缺一不可
想把组件封装好,Custom Elements、Shadow DOM 和 HTML Templates 这三个技术必须配合使用。
- Custom Elements(自定义元素):让你创建新的 HTML 标签,比如 <my-button>。通过 javaScript 定义类并继承 HTMLElement,再用 customElements.define() 注册就行。标签名必须带短横线,避免和标准 HTML 冲突。
- Shadow DOM(影子 DOM):解决样式污染的关键。调用 this.attachShadow({mode: ‘open’}) 创建一个独立的作用域,里面的 css 不会泄漏到全局,外部样式也影响不到内部结构,实现真正的隔离。
- HTML Templates(模板):用 <template> 标签预定义组件的 HTML 结构。这个内容不会立即渲染,直到 js 在运行时把它克隆并插入到 Shadow DOM 中,提升性能和复用性。
组件行为与生命周期控制
自定义元素类不只是放 HTML,还能绑定完整的交互逻辑和状态管理。
- connectedCallback():元素被添加到页面时触发,适合做初始化操作,比如绑定事件监听器或获取属性值来渲染内容。
- attributeChangedCallback():当元素的某些属性变化时执行。需要先在 Static get observedAttributes() 里声明要监听的属性列表,然后在这里处理更新逻辑,实现响应式效果。
- <slot>:在 Shadow DOM 内部使用 <slot> 可以预留内容插入点,支持外部传入文本或元素,让组件更灵活,类似其他框架里的“插槽”概念。
跨框架使用的实际方案
Web Components 的最大优势就是通用性,无论项目用什么技术栈都能集成。
- 在 Vue 或 React 项目中,可以直接像普通标签一样使用自定义元素,传属性、监听事件都没问题。例如,给 <my-counter on-increase=”handle”> 绑定事件即可。
- 如果用 Vue 开发复杂组件,可以通过 @vue/web-component-wrapper 工具把 .vue 文件打包成 Web Component,享受 Vue 的开发体验同时输出标准组件。
- 发布时可以打包成 npm 包,或者通过 CDN 分发,团队内部共享组件库变得非常简单,统一设计系统也更容易落地。
基本上就这些,不需要复杂的构建配置,就能做出独立、稳定、长期可用的 UI 组件。虽然学习曲线比框架组件稍陡,但换来的是自由度和持久性。