Web Components 通过自定义元素、影子 DOM 和 HTML 模板实现可复用、封装良好的独立组件。1. 使用 customElements.define() 注册带连字符的自定义标签;2. 类继承 HTMLElement 定义行为;3. 在构造函数中用 this.attachShadow() 创建影子根实现样式结构隔离;4. 利用 预定义复杂 DOM 结构,提升性能与维护性。示例包含按钮、卡片和模态框组件,支持跨项目复用且无需框架依赖。

Web Components 是一组浏览器原生支持的 API,允许你创建可复用、封装良好且独立的自定义 HTML 元素。它不依赖任何框架,适用于任何前端项目。要实现一个可复用的自定义元素,主要依靠三项技术:自定义元素(Custom Elements)、影子 DOM(Shadow DOM)和 HTML 模板()。
定义自定义元素
使用 customElements.define() 方法注册一个新的 HTML 标签。标签名必须包含连字符(-),以避免与标准 HTML 元素冲突。
创建类继承自 HTMLElement,并在其中定义元素的行为。
class MyButton extends HTMLElement {
constructor() {
super();
this.textContent = this.getAttribute('label') || '点击我';
this.style.padding = '10px 20px';
this.style.backgroundColor = '#007bff';
this.style.color = 'white';
this.style.borderRadius = '4px';
this.style.cursor = 'pointer';
}
connectedCallback() {
this.addEventListener('click', () => {
alert('按钮被点击!');
});
}
}
customElements.define('my-button', MyButton);
之后即可在 HTML 中使用:
立即学习“前端免费学习笔记(深入)”;
使用影子 DOM 封装样式和结构
影子 DOM 能将元素的内部结构和样式隔离,防止外部 CSS 干扰,也避免内部样式泄露。
在构造函数中调用 this.attachShadow({ mode: 'open' }) 创建影子根,然后向其中添加标记和样式。
class MyCard extends HTMLElement {
constructor() {
super();
const shadow = this.attachShadow({ mode: 'open' });
const wrapper = document.createElement('div');
wrapper.innerHTML = `
${this.getAttribute('title')}
`;
shadow.appendChild(wrapper);
}
}
customComponents.define('my-card', MyCard);
使用示例:
姓名:张三
年龄:25
结合模板提升性能和可维护性
对于复杂结构,推荐使用 预定义 DOM 结构,避免在 JS 中拼接字符串。
将模板放在页面不可见区域,通过克隆实例化内容。
基本上就这些。通过组合自定义元素、影子 DOM 和模板,你可以构建出高度封装、样式隔离、行为清晰的可复用组件,直接在任何网页或现代框架中使用,无需额外依赖。











