HTML组件化有五种方案:一、HTML Templates+JS实例化;二、Custom Elements(Web Components);三、Server-Side Includes(SSI);四、ES Modules动态导入HTML片段;五、构建工具驱动的HTML组件化(如Vite+HTML预处理器)。

如果您希望在HTML项目中实现组件的复用与维护性提升,但缺乏标准化的封装机制,则可能是由于原生HTML未提供内置的模块化语法支持。以下是实现HTML可复用组件的多种模块化开发方案:
一、HTML Templates + JavaScript实例化
利用元素声明不可渲染的HTML结构片段,配合JavaScript动态克隆、填充并插入DOM,实现轻量级组件封装。该方式不依赖构建工具,兼容性好,适用于渐进式增强场景。
1、在HTML文档中定义,内部编写带占位符的结构,如。
2、编写工厂函数createCard({ title, content }),使用document.getElementById('card-template').content.cloneNode(true)获取模板内容。
立即学习“前端免费学习笔记(深入)”;
3、遍历节点查找data-bind属性,将传入参数值写入对应元素的textContent或innerHTML。
4、调用document.body.appendChild(clonedFragment)完成挂载。
二、Custom Elements(Web Components标准)
通过浏览器原生支持的Custom Elements API定义自定义HTML标签,实现语义化、可复用、封装样式的组件。组件具备生命周期钩子、属性响应、Shadow DOM隔离能力,是现代HTML模块化的推荐路径。
1、使用class CardComponent extends HTMLElement声明类,继承HTMLElement。
2、在constructor()中调用super()并创建this.attachShadow({ mode: 'open' })启用Shadow DOM。
3、在connectedCallback()中定义模板内容,例如this.shadowRoot.innerHTML = `
。
4、使用customElements.define('my-card', CardComponent)注册组件,并在HTML中以形式使用。
三、Server-Side Includes(SSI)静态包含
在支持SSI的Web服务器(如Apache、Nginx配置启用)环境下,通过注释指令将外部HTML文件内容嵌入当前页面,实现服务端级别的组件复用。适用于纯静态站点且无需交互逻辑的场景。
1、确保服务器已启用SSI模块,Apache中需在.htaccess或虚拟主机配置中添加Options +Includes及AddType text/html .shtml。
2、将公共头部保存为header.html,内容为。网站名称
JTBC CMS(5.0) 是一款基于PHP和MySQL的内容管理系统原生全栈开发框架,开源协议为AGPLv3,没有任何附加条款。系统可以通过命令行一键安装,源码方面不基于任何第三方框架,不使用任何脚手架,仅依赖一些常见的第三方类库如图表组件等,您只需要了解最基本的前端知识就能很敏捷的进行二次开发,同时我们对于常见的前端功能做了Web Component方式的封装,即便是您仅了解HTML/CSS也
3、在主页面文件扩展名改为.shtml,插入指令。
4、访问该页面时,服务器会在响应前将header.html内容替换到指令位置,返回完整HTML。
四、ES Modules动态导入HTML片段
结合现代JavaScript模块系统,将HTML字符串封装为ES模块导出,通过import()动态加载并在运行时注入DOM。该方式支持按需加载、Tree-shaking及类型提示,适合构建工具链完整的项目。
1、新建button-component.js,导出默认函数:export default function Button({ label, onClick }) { return ``; }。
2、在主脚本中使用import Button from './button-component.js'引入。
3、调用Button({ label: '提交', onClick: 'handleSubmit()' })生成HTML字符串。
4、使用element.insertAdjacentHTML('beforeend', htmlString)将结果插入目标容器。
五、构建工具驱动的HTML组件化(如Vite + HTML预处理器)
借助Vite等构建工具插件(如vite-plugin-html或vite-plugin-vue),将HTML文件视为模块,支持语法、变量插值、条件渲染等高级特性,最终编译为标准HTML输出。
1、安装vite-plugin-html并配置vite.config.js,启用html插件支持include标签。
2、创建components/navbar.html,内容含。
3、在入口HTML中写入。
4、启动vite build后,插件自动解析include标签,替换变量并内联HTML内容,生成最终静态文件。










