用WebComponents实现组件复用技巧
时间：2025-11-13 11:42:55 429浏览 收藏
“纵有疾风来，人生不言弃”，这句话送给正在学习文章的朋友们，也希望在阅读本文《用Web Components打造可复用组件方法》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新文章相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！
Web Components 通过自定义元素、影子 DOM 和 HTML 模板实现可复用、高封装的 UI 组件，支持跨框架使用；1. 自定义元素定义新标签并注册行为；2. 影子 DOM 隔离组件样式与结构；3. 模板提升复杂结构的可维护性；4. 属性监听实现响应式更新；结合 slot 可增强内容分发灵活性，适用于构建设计系统。
Web Components 是一套允许开发者创建可复用、封装良好且无需依赖框架的自定义 HTML 元素的技术。它由三项核心技术组成：自定义元素（Custom Elements）、影子 DOM（Shadow DOM）和 HTML 模板（）。利用这些技术，可以构建出跨项目、跨框架使用的组件，非常适合需要长期维护或在多个项目中共享 UI 功能的场景。
创建自定义元素
自定义元素让你能够定义新的 HTML 标签，并赋予其行为。通过 customElements.define() 方法注册一个类继承自 HTMLElement 的构造函数。
class MyButton extends HTMLElement {
connectedCallback() {
this.innerHTML = `<button style="padding: 10px; background: #007bff; color: white; border: none; border-radius: 4px;">
${this.getAttribute('label') || '按钮'}
</button>`;
}
}
customElements.define('my-button', MyButton);
之后就可以在 HTML 中直接使用：
使用影子 DOM 实现样式隔离
直接操作 innerHTML 容易导致样式冲突。为了解决这个问题，可以使用影子 DOM 将组件内部结构与外部页面隔离开来。
class MyCard extends HTMLElement {
constructor() {
super();
this.attachShadow({ mode: 'open' });
}
connectedCallback() {
const title = this.getAttribute('title') || '默认标题';
const content = this.getAttribute('content') || '这是内容';
this.shadowRoot.innerHTML = `
<style>
.card {
border: 1px solid #ddd;
border-radius: 8px;
padding: 16px;
box-shadow: 0 2px 4px rgba(0,0,0,0.1);
font-family: sans-serif;
}
h3 { margin-top: 0; color: #333; }
</style><div class="card">
<h3>${title}</h3>
<p>${content}</p>
</div>
`;
}
}
customElements.define('my-card', MyCard);
通过 this.attachShadow({ mode: 'open' }) 创建影子根节点，所有内部结构和样式都限定在这个范围内，不会影响页面其他部分。
结合模板提升性能与可维护性
对于结构较复杂的组件，频繁拼接字符串不利于维护。HTML 的 标签提供了一种声明式方式来定义组件结构。
在 HTML 文件中定义模板：
<template id="my-alert-template">
<style>
.alert {
padding: 12px;
border-left: 4px solid #ffc107;
background-color: #fff3cd;
color: #856404;
border-radius: 4px;
}
</style>
<div class="alert">
<slot>默认提示信息</slot>
</div>
</template>
在组件中引用该模板：
class MyAlert extends HTMLElement {
constructor() {
super();
this.attachShadow({ mode: 'open' });
const template = document.getElementById('my-alert-template');
this.shadowRoot.appendChild(template.content.cloneNode(true));
}
}
customElements.define('my-alert', MyAlert);
实现属性监听与响应更新
为了让组件对属性变化做出反应，可以在自定义元素中定义 observedAttributes 静态属性，并实现 attributeChangedCallback 方法。
class MyInput extends HTMLElement {
constructor() {
super();
this.attachShadow({ mode: 'open' });
}
static get observedAttributes() {
return ['value', 'placeholder'];
}
attributeChangedCallback(name, oldValue, newValue) {
if (name === 'value') {
const input = this.shadowRoot.querySelector('input');
if (input) input.value = newValue;
}
}
connectedCallback() {
this.shadowRoot.innerHTML = `
<input type="text"
value="${this.getAttribute('value') || ''}"
placeholder="${this.getAttribute('placeholder') || ''}" />
`;
}
}
customElements.define('my-input', MyInput);
这样当外部修改 value 属性时，组件会自动更新输入框的值。
基本上就这些。通过组合自定义元素、影子 DOM 和模板机制，你可以构建出真正独立、可复用、易于集成的 Web 组件。它们不依赖任何框架，可在 React、Vue 或纯 HTML 项目中直接使用，是打造设计系统或组件库的理想选择。不复杂但容易忽略的是细节封装和用户体验的一致性。
终于介绍完啦！小伙伴们，这篇关于《用WebComponents实现组件复用技巧》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！
-
502 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
474 收藏
-
352 收藏
-
243 收藏
-
337 收藏
-
419 收藏
-
340 收藏
-
183 收藏
-
350 收藏
-
105 收藏
-
205 收藏
-
369 收藏
-
176 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案，代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景，打造一站式知识长龙服务，适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例，全面具体可落地，从理论到实践，一步一步将GO核心编程技术、编程思想、底层实现融会贯通，使学习者贴近时代脉搏，做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信：Le-studyg；在课程中，我们将首先介绍MySQL8的新特性，包括性能优化、安全增强、新数据类型等，帮助学生快速熟悉MySQL8的最新功能。接着，我们将深入解析MySQL的网络通信机制，包括协议、连接管理、数据传输等，让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网，分为导航，轮播，关于我们，成功案例，服务流程，团队介绍，数据部分，公司动态，底部信息等内容区块。网站整体采用CSSGrid布局，支持响应式，有流畅过渡和展现动画。
- 立即学习 485次学习