是否存在类似CSS样式表、外部JS脚本的HTML公共模板引入方案?
HTML公共模板复用方案汇总
以下是不同开发场景下可直接使用的引入方案,无需每次复制完整模板:
1. 原生客户端无依赖方案
适合纯静态站点、没有使用构建工具或服务端语言的场景:
- 方案1:
<object>标签直接引入
在需要插入公共片段(如导航栏)的位置写入如下代码即可:<object type="text/html" data="你的公共片段路径.html" width="100%" height="auto"></object>
说明:公共片段的样式可以单独写在片段文件内,也可以统一写在父页面的全局CSS中 - 方案2:轻量JS动态加载
封装通用加载函数,在所有页面复用即可,示例代码:
页面调用方式:在需要插入公共片段的位置写占位标签// 全局公共函数,写在全站共用的JS文件中 function loadPartial(selector, filePath) { fetch(filePath) .then(response => response.text()) .then(html => document.querySelector(selector).innerHTML = html) }<div id="nav-placeholder"></div>,在页面底部执行loadPartial('#nav-placeholder', 'nav.html')即可。
2. 服务端渲染方案
如果站点使用服务端语言开发,可直接用服务端内置的模板引入能力,渲染阶段就把片段嵌入页面,没有客户端加载延迟:
- PHP场景:使用
<?php include '公共片段路径.html'; ?>直接插入对应位置 - Node.js(Express/EJS等模板引擎):使用
<%- include('公共片段路径.html') %>语法 - Python(Django/Flask):使用
{% include "公共片段路径.html" %}模板标签
3. 构建工具开发方案
如果使用Vite、Webpack等前端构建工具,或者使用静态站点生成器开发,这是目前最常用的方案,打包阶段直接把公共片段嵌入到对应页面:
- 打包工具可搭配HTML处理插件,配置完成后直接在HTML中使用
@@include('公共片段路径.html')类的语法引入 - Hexo、Hugo、Eleventy等静态站点生成器均内置了模板片段引入能力,直接调用官方提供的partial语法即可
常见问题规避
- 客户端引入方案中,公共片段内的相对路径资源(图片、CSS、JS)建议用绝对路径,避免父页面层级不同导致资源加载失败
- 如果公共片段包含交互逻辑,建议把JS代码写在全站共用的全局脚本中,或者确保片段加载完成后再执行对应逻辑,避免事件绑定失效
内容的提问来源于stack exchange,提问作者user14268125
相关产品推荐
相关产品推荐

