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

用 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 CMS(5.0) 是一款基于PHP和MySQL的内容管理系统原生全栈开发框架,开源协议为AGPLv3,没有任何附加条款。系统可以通过命令行一键安装,源码方面不基于任何第三方框架,不使用任何脚手架,仅依赖一些常见的第三方类库如图表组件等,您只需要了解最基本的前端知识就能很敏捷的进行二次开发,同时我们对于常见的前端功能做了Web Component方式的封装,即便是您仅了解HTML/CSS也
支持属性、事件和插槽实现完整交互
为了让组件更灵活,需处理属性变化、对外派发事件以及内容分发。
- 通过 observedAttributes 监听属性变化并更新 UI
- 使用 this.dispatchEvent(new CustomEvent(...)) 向外通知用户操作(如点击)
- 使用
支持内容投影,让使用者传入自定义内容
例如:
this.shadowRoot.innerHTML = ``;
使用时:
在不同框架中直接使用 Web Components
由于是原生 HTML 标签,可以在各种框架中无缝集成:
- React:直接当作普通标签使用,注意属性传递要用 setAttribute 或 refs 处理非字符串值
- Vue:在 template 中使用即可,props 可通过 attributes 传入
- Angular:需在模块中配置 CUSTOM_ELEMENTS_SCHEMA 来避免模板报错
无需适配器也能工作,真正实现“写一次,到处用”。
基本上就这些。只要遵循标准、合理封装样式与行为,并提供清晰文档,就能构建出轻量、稳定、跨框架的 UI 组件库。不复杂但容易忽略细节,比如属性监听、事件命名规范和 SSR 兼容性处理。









