HTML5 Web Components 通过 Custom Elements、Shadow DOM 和 HTML 模板实现原生组件化开发，支持自定义标签、样式隔离、模板复用与属性响应，适用于轻量级项目和跨框架组件共享。
HTML5 Web Components 是一套可以让开发者创建可复用、封装良好的自定义 HTML 元素的技术。它不依赖任何框架，原生支持现代浏览器，适合构建组件化前端应用。核心由三项技术组成：自定义元素（Custom Elements）、影子 DOM（Shadow DOM）和 HTML 模板（<template>）。下面介绍如何使用它们实现组件化开发。
1. 使用 Custom Elements 定义自定义标签
Custom Elements 允许你定义自己的 HTML 标签，并绑定 JavaScript 类来控制其行为。
通过 customElements.define() 方法注册一个新元素，例如创建一个 <my-card> 组件：
class MyCard extends HTMLElement {
constructor() {
super();
this.innerHTML = `
<h3>${this.getAttribute('title')}</h3>
<p>${this.textContent}</p>
`;
}
}
customElements.define('my-card', MyCard);
之后就可以在页面中使用：
立即学习“前端免费学习笔记（深入）”；
<my-card title="欢迎">这是一个自定义卡片组件</my-card>2. 利用 Shadow DOM 实现样式与结构隔离
Shadow DOM 能将组件的 DOM 和 CSS 封装起来，避免全局污染。在构造函数中调用 attachShadow() 创建影子根节点。
修改上面的例子，加入 Shadow DOM：
class MyCard extends HTMLElement {
constructor() {
super();
const shadow = this.attachShadow({ mode: 'open' });
const title = this.getAttribute('title');
const content = this.textContent;
shadow.innerHTML = `
<style>
:host {
display: block;
border: 1px solid #ddd;
border-radius: 8px;
padding: 16px;
font-family: sans-serif;
}
h3 {
margin: 0;
color: #005a9c;
}
p {
color: #333;
}
</style>
<h3>${title}</h3>
<p>${content}</p>
`;
}
}
customElements.define('my-card', MyCard);
:host 是 Shadow DOM 中的关键选择器，用于选中组件本身。
使用 `@ainative/vue-sdk` 为 Vue 3 应用添加 AI 聊天功能。适用于以下场景：(1) 安装 `@ainative/vue-sdk`，(2) 在 Vue 组件中使用 `useChat` 组合式函数，(3) 提供……
3. 使用 <template> 提前定义组件模板
对于结构较复杂的组件，建议使用 <template> 标签预定义 HTML 模板，提升性能和可维护性。
在 HTML 中定义模板：
<template id="card-template">
<style>
:host { display: block; border: 1px solid #ccc; padding: 1em; }
h3 { color: #0066cc; }
</style>
<h3><slot name="title">默认标题</slot></h3>
<p><slot>默认内容</slot></p>
</template>
JavaScript 中使用模板实例化：
class MyCard extends HTMLElement {
constructor() {
super();
const template = document.getElementById('card-template');
const content = template.content.cloneNode(true);
this.attachShadow({ mode: 'open' }).appendChild(content);
}
}
customElements.define('my-card', MyCard);
配合 <slot> 可实现内容分发，让外部传入的内容插入到指定位置。
4. 支持属性监听与状态更新
通过定义 observedAttributes 和 attributeChangedCallback，可以监听属性变化并响应更新。
class MyCard extends HTMLElement {
static get observedAttributes() {
return ['title', 'theme'];
}
attributeChangedCallback(name, oldValue, newValue) {
if (name === 'title' && this.shadowRoot) {
const h3 = this.shadowRoot.querySelector('h3');
if (h3) h3.textContent = newValue;
}
if (name === 'theme') {
this.shadowRoot.host.style.backgroundColor = newValue === 'dark' ? '#333' : '#fff';
}
}
}
这样当外部修改属性时，组件能自动更新界面。
基本上就这些。HTML5 Web Components 提供了原生的组件化能力，无需引入框架即可实现高内聚、低耦合的 UI 模块。虽然生态不如 React 或 Vue 丰富，但在轻量级项目、设计系统或跨框架组件共享中非常实用。关键是理解 Custom Elements、Shadow DOM 和 <template> 的协作方式，就能写出干净可复用的组件。
