0

0

如何用Web Components构建跨框架的UI组件库?

狼影

狼影

发布时间:2025-10-06 13:32:01

|

195人浏览过

|

来源于php中文网

原创

使用原生 Web Components 可构建跨框架 UI 组件库,核心是通过 Custom Elements 定义标签、Shadow DOM 隔离样式、Slot 实现内容分发,并在各框架中直接使用,实现一次开发、多处运行。

如何用web components构建跨框架的ui组件库?

用 Web Components 构建跨框架的 UI 组件库,核心在于利用浏览器原生能力封装可复用、独立且可在任意前端框架中使用的 UI 元素。它不依赖 React、Vue 或 Angular 的特定语法,而是基于标准 HTML、CSS 和 JavaScript 实现真正的框架无关性。

使用原生 Custom Elements 创建组件

Custom Elements 是 Web Components 的核心之一,允许你定义自己的 HTML 标签。

通过 customElements.define() 方法注册一个类继承自 HTMLElement 的自定义元素:

class MyButton extends HTMLElement {
  connectedCallback() {
    if (!this.rendered) {
      this.innerHTML = ``;
      this.rendered = true;
    }
  }
}

customElements.define('my-button', MyButton);

之后就可以在任何页面或框架模板中使用:提交

结合 Shadow DOM 实现样式隔离

Shadow DOM 能为组件创建独立的作用域,避免全局样式污染,也防止外部 CSS 影响组件内部结构。

在组件构造函数中挂载 Shadow Root:

constructor() {
  super();
  this.attachShadow({ mode: 'open' });
}

connectedCallback() {
  this.shadowRoot.innerHTML = `
    
    
  `;
}

这样组件的样式不会泄露,也不会被外部样式覆盖,适合构建稳定 UI 库。

JTBC网站内容管理系统5.0.3.1
JTBC网站内容管理系统5.0.3.1

JTBC CMS(5.0) 是一款基于PHP和MySQL的内容管理系统原生全栈开发框架,开源协议为AGPLv3,没有任何附加条款。系统可以通过命令行一键安装,源码方面不基于任何第三方框架,不使用任何脚手架,仅依赖一些常见的第三方类库如图表组件等,您只需要了解最基本的前端知识就能很敏捷的进行二次开发,同时我们对于常见的前端功能做了Web Component方式的封装,即便是您仅了解HTML/CSS也

下载

支持属性、事件和插槽实现完整交互

为了让组件更灵活,需处理属性变化、对外派发事件以及内容分发。

  • 通过 observedAttributes 监听属性变化并更新 UI
  • 使用 this.dispatchEvent(new CustomEvent(...)) 向外通知用户操作(如点击)
  • 使用 支持内容投影,让使用者传入自定义内容

例如:

this.shadowRoot.innerHTML = `
  
`;

使用时:带图标的按钮svg...>,内容会自动插入到 slot 位置。

在不同框架中直接使用 Web Components

由于是原生 HTML 标签,可以在各种框架中无缝集成:

  • React:直接当作普通标签使用,注意属性传递要用 setAttribute 或 refs 处理非字符串值
  • Vue:在 template 中使用即可,props 可通过 attributes 传入
  • Angular:需在模块中配置 CUSTOM_ELEMENTS_SCHEMA 来避免模板报错

无需适配器也能工作,真正实现“写一次,到处用”。

基本上就这些。只要遵循标准、合理封装样式与行为,并提供清晰文档,就能构建出轻量、稳定、跨框架的 UI 组件库。不复杂但容易忽略细节,比如属性监听、事件命名规范和 SSR 兼容性处理。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
typedef和define区别
typedef和define区别

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

109

2023.09.26

define的用法
define的用法

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

338

2023.10.11

if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

778

2023.08.22

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

298

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

212

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1501

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

624

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

633

2024.03.22

clawdbot ai使用教程 保姆级clawdbot部署安装手册
clawdbot ai使用教程 保姆级clawdbot部署安装手册

Clawdbot是一个“有灵魂”的AI助手,可以帮用户清空收件箱、发送电子邮件、管理日历、办理航班值机等等,并且可以接入用户常用的任何聊天APP,所有的操作均可通过WhatsApp、Telegram等平台完成,用户只需通过对话,就能操控设备自动执行各类任务。

15

2026.01.29

热门下载

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

精品课程

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

共28课时 | 3.6万人学习

React 教程
React 教程

共58课时 | 4.3万人学习

MongoDB 教程
MongoDB 教程

共17课时 | 2.4万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号