讲师中心 微信公众号
AI工具推荐 视频效率加速

怎样利用Web Components构建跨框架复用的业务组件?

秋涛小哥_2684

秋涛小哥_2684

发布时间:2025-09-27 13:10:01

|

858人浏览过

|

来源于php中文网

原创

Web Components通过Custom Elements和Shadow DOM实现跨框架复用,支持属性通信与事件交互,结合ES模块打包可构建稳定通用的企业级组件。

怎样利用web components构建跨框架复用的业务组件?

Web Components 是一套浏览器原生支持的技术,能让开发者创建可重用、封装良好且不依赖框架的自定义元素。在多技术栈并存的业务场景中,利用 Web Components 构建跨框架复用的业务组件是一种高效、稳定的方案。

使用原生 Custom Elements 定义组件

Custom Elements 是 Web Components 的核心之一,允许你定义自己的 HTML 标签。通过 customElements.define() 方法注册组件类,即可在任意页面或框架中使用。

例如,定义一个通用的用户信息卡片:

class UserInfoCard extends HTMLElement {
  constructor() {
    super();
    this.attachShadow({ mode: 'open' });
  }

  connectedCallback() {
    const name = this.getAttribute('name') || 'Unknown';
    this.shadowRoot.innerHTML = `
Hello, ${name}!
`;
  }
}

customElements.define('user-info-card', UserInfoCard);

之后在 React、Vue 或纯 HTML 中都能直接使用 ,无需适配。

结合 Shadow DOM 实现样式与逻辑隔离

Shadow DOM 提供了真正的封装能力,确保组件内部的 CSS 不会污染全局,也不会被外部样式影响。

在上面的例子中,通过 this.attachShadow({ mode: 'open' }) 创建影子根,将模板和样式限制在组件内部。

你可以进一步引入样式表:

const style = document.createElement('style');
style.textContent = `
  .card {
    padding: 16px;
    border: 1px solid #ddd;
    border-radius: 4px;
    background: #f9f9f9;
  }
`;
this.shadowRoot.appendChild(style);

这样无论宿主环境使用什么 UI 框架,组件外观都保持一致。

通过属性和事件实现跨框架通信

Web Components 通过 HTML 属性接收输入,通过自定义事件向外传递状态变化,天然适合跨框架集成。

例如,让组件支持点击反馈:

this.shadowRoot.innerHTML += ``;
this.shadowRoot.querySelector('button').addEventListener('click', () => {
  this.dispatchEvent(new CustomEvent('user-action', {
    bubbles: true,
    composed: true,
    detail: { action: 'greet' }
  }));
});

在 Vue 或 React 中监听事件:

或使用 addEventListener 动态绑定。bubbles 和 composed 设置为 true 可穿透 Shadow DOM 和框架边界。

打包与分发建议

将 Web Components 打包为独立的 JavaScript 模块(如 ES Module),通过 CDN 或 npm 发布。

构建时可使用工具如 Vite、Rollup 配合 @web/dev-server 等支持原生模块开发。

建议:

  • 使用 TypeScript 增强类型安全
  • 提供 defaultProps 和 attributeChangedCallback 支持动态属性更新
  • 文档化 attributes、events、slots 方便团队使用
  • 通过 支持内容投影,提升灵活性

基本上就这些。Web Components 虽不花哨,但胜在稳定通用,特别适合构建企业级公共业务组件,比如登录框、数据展示卡片、操作确认弹窗等需要多端复用的场景。

热门AI工具

更多
UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

相关专题

更多
TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

312

2026.02.13

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

520

2026.02.25

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

371

2026.03.13

TypeScript 全栈开发进阶指南
TypeScript 全栈开发进阶指南

面向有 JavaScript 基础的开发者,深入讲解 TypeScript 的类型系统与全栈开发实践。

286

2026.06.03

TypeScript Node.js 全栈工程化与Monorepo架构实践
TypeScript Node.js 全栈工程化与Monorepo架构实践

本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

658

2026.06.16

typedef和define区别
typedef和define区别

typedef和define区别在类型检查、作用范围、可读性、错误处理和内存占用等。本专题为大家提供typedef和define相关的文章、下载、课程内容,供大家免费下载体验。

313

2023.09.26

define的用法
define的用法

define用法:1、定义常量;2、定义函数宏:3、定义条件编译;4、定义多行宏。更多关于define的用法的内容,大家可以阅读本专题下的文章。

619

2023.10.11

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2278

2023.09.20

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

60

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 1.5万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 6.1万人学习

CSS教程
CSS教程

共754课时 | 98.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn