web components由custom elements、shadow dom和html templates组成，提供框架无关的组件化方案，适用于微前端、设计系统等场景，具备原生支持、良好封装性和跨框架复用优势。
Web Components 是一套由 W3C 标准组织定义的浏览器原生支持的技术，它让开发者可以创建可复用、封装良好且无需依赖框架的自定义 HTML 元素。在现代前端开发中，虽然 React、Vue 等框架提供了组件化能力，但 Web Components 提供了真正意义上的“框架无关”组件方案，尤其适合构建设计系统、跨项目复用组件或嵌入第三方内容。
1. Web Components 的核心技术组成
Web Components 并非单一技术，而是由三项关键技术构成：Custom Elements（自定义元素）、Shadow DOM（影子 DOM）和 HTML Templates（HTML 模板）。
Custom Elements允许开发者定义新的 HTML 标签，并将其与 JavaScript 类绑定。通过 customElements.define() 方法注册组件，浏览器就能识别并实例化这个新标签。
例如：
Snowy（SnowyAdmin）是国内首个国密前后端分离快速开发平台，集成国密加解密插件， 软件层面完全符合等保测评要求，同时实现国产化机型、中间件、数据库适配，是您的不二之选！ 技术框架与密码结合，让更多的人认识密码，使用密码；更是让前后分离“密”不可分。采用SpringBoot+MybatisPlus+AntDesignVue+Vite 等更多组件及前沿技术开发，注释丰富，代码简洁，开箱即用
立即学习“Java免费学习笔记（深入）”；
class MyButton extends HTMLElement {
connectedCallback() {
this.textContent = '点击我';
this.style.padding = '10px';
this.style.background = '#007bff';
this.style.color = 'white';
this.style.borderRadius = '4px';
this.onclick = () => alert('按钮被点击');
}
}
customElements.define('my-button', MyButton);
之后即可在 HTML 中使用：<my-button></my-button>
为组件提供独立的 DOM 和样式作用域，避免全局污染。通过 this.attachShadow({ mode: 'open' }) 创建影子根节点，所有内部结构和样式都封装在其中。
示例：
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;
background: #f9f9f9;
}
</style>
<div class="card">
<slot></slot>
</div>
`;
}
}
customElements.define('my-card', MyCard);
Shadow DOM 中的样式不会影响外部页面，外部样式也不会轻易穿透进来，实现真正的样式隔离。
HTML Templates<template></template> 标签用于声明一段不立即渲染的 HTML 结构，可在 JavaScript 中克隆后动态插入。它是构建复杂组件模板的基础。
例如：
立即学习“Java免费学习笔记（深入）”；
<template id="my-modal-template">
<div class="modal" style="display:none">
<div class="content"><slot></slot></div>
<button class="close">关闭</button>
</div>
</template>
在组件中通过 document.getElementById('my-modal-template').content.cloneNode(true) 获取模板内容并添加到 Shadow DOM。
2. 生命周期回调函数
自定义元素类支持多个生命周期钩子，便于控制组件行为：
- connectedCallback：元素插入 DOM 时调用，适合初始化渲染、事件绑定
- disconnectedCallback：元素从 DOM 移除时调用，可用于清理定时器或事件监听
- attributeChangedCallback：监控属性变化，需配合 observedAttributes 静态属性使用
- adoptedCallback：元素被移动到新文档时触发（较少使用）
示例：响应属性变化
class MyImage extends HTMLElement {
static get observedAttributes() {
return ['src', 'alt'];
}
attributeChangedCallback(name, oldValue, newValue) {
if (name === 'src') {
this.imgElement.src = newValue;
}
}
connectedCallback() {
this.imgElement = document.createElement('img');
this.imgElement.src = this.getAttribute('src') || '';
this.imgElement.alt = this.getAttribute('alt') || '';
this.appendChild(this.imgElement);
}
}
customElements.define('my-image', MyImage);
3. 实际应用场景与优势
Web Components 特别适用于以下场景：
- 微前端架构：不同团队使用不同技术栈开发组件，通过 Web Components 统一集成
- UI 库/设计系统：构建可跨 React、Vue、Angular 使用的通用组件库
- 嵌入式小工具：如广告位、登录框、客服浮窗等需要嵌入第三方网站的功能模块
- 长期维护项目**：减少对特定框架版本升级的依赖，提升稳定性
优势包括：
- 原生支持，无需额外依赖
- 良好的封装性与隔离性
- 可继承原生 HTML 元素行为
- 支持 SEO（服务端可渲染模板）
4. 兼容性与现代开发实践
目前主流浏览器均已支持 Web Components（IE 不支持，Edge 起支持）。对于旧浏览器，可通过 polyfill（如 @webcomponents/webcomponentsjs）兼容。
在实际项目中，可结合工具链提升开发效率：
- Lit：Google 推出的轻量级库，简化模板、响应式更新和装饰器使用
- Stencil：编译型框架，用类似 TypeScript + JSX 的方式生成标准 Web Components
- Builder.io 或 Open WC：提供脚手架、测试工具和最佳实践指导
基本 Lit 示例：
import { LitElement, html, css } from 'lit';
class MyGreeting extends LitElement {
static properties = {
name: { type: String },
};
static styles = css` p { color: blue; } `;
render() {
return html`<p>你好，${this.name}！</p>`;
}
}
customElements.define('my-greeting', MyGreeting);
基本上就这些。Web Components 虽不如框架组件生态丰富，但在追求解耦、长期稳定和跨框架复用的场景下，是不可替代的技术选择。掌握其核心机制，能让你写出更健壮、更具扩展性的前端代码。
