如何将div嵌入所有HTML页面
时间:2026-02-18 12:00:48 465浏览 收藏
浏览器原生不支持HTML include机制,因此在纯静态页面中复用div(如页头页脚)无法直接通过类似``实现;文章系统梳理了三种主流可行方案:最轻量的是JavaScript动态加载(fetch + insertAdjacentHTML),适合无构建流程的静态站点,但需本地服务支持且依赖JS执行;其次是构建工具(如Vite、Webpack)在编译时注入HTML片段,可靠、无运行时请求、支持模板逻辑,但需配套工程化环境;最后是服务端模板引擎(如EJS、Hugo、Next.js)的include/partial机制,真正实现服务端拼接、SEO友好、零JS依赖,适合有后端或SSG场景;选择取决于你的技术栈和部署约束——没有万能解法,但明确知道每种方案的适用边界与坑点,才能避免踩空。

用 include 无法直接在纯 HTML 中复用 div?没错,浏览器不支持
原生 HTML 没有内置的 include 机制,直接写 或类似语法,在本地双击打开或静态服务器上默认不生效。这不是你配置错,是浏览器根本不管这行代码——它只对启用了 SSI(Server Side Includes)的 Apache/Nginx 有效,且需额外开启模块和设置 MIME 类型。
所以别试了,除非你明确在配好 SSI 的生产环境里部署,否则这条路走不通。
最轻量、免构建的方案:用 JavaScript 动态加载 fetch + insertAdjacentHTML
适合已有静态页面、不想引入框架、又希望快速统一 header/footer 的场景。核心逻辑是:页面加载后,用 fetch 读取一个独立的 header.html 文件内容,再插入到指定容器中。
- 把公共 div 写进单独文件,比如
nav.html,内容只保留纯 HTML 片段:<nav><a href="/home">首页</a><a href="/about">关于</a></nav>
- 在每个页面底部加一段脚本:
<script> fetch('nav.html') .then(r => r.text()) .then(html => document.getElementById('nav-container').insertAdjacentHTML('beforeend', html)); </script> - 对应页面中预留挂载点:
- 注意路径是相对当前 HTML 的;如果用
file://协议(双击打开),fetch会因跨域被浏览器拦截,必须起一个本地服务(如npx serve或 VS Code Live Server)
Webpack/Vite 等构建工具里,用 html-webpack-plugin 或 vite-plugin-html 注入
如果你项目已用构建工具,这是更可靠、支持编译时校验的方式。它不是运行时请求,而是打包阶段就把内容“塞进去”,无网络依赖、无 CSP 风险。
- 以 Vite 为例,装
vite-plugin-html后,在vite.config.ts里写:import { injectHtml } from 'vite-plugin-html' export default defineConfig({ plugins: [injectHtml({ injectData: { nav: '<nav>...</nav>' } })] }) - 然后在
index.html里用<%= nav %>占位(插件会替换) - 优势:支持模板变量、可复用 JSON 数据、能做条件注入(比如不同环境注入不同 div)
- 坑点:注入的是字符串,不是 DOM 节点,如果里面含
,不会自动执行;需要手动eval或动态创建 script 标签(不推荐)
服务端渲染(SSR)或 CMS 场景下,优先用模板引擎的 include 或 partial
如果你用 Express + EJS、Nuxt、Next、Hugo、Jekyll 等,这才是正解。它们在生成 HTML 时就拼好了,最终发给浏览器的就是完整结构,没运行时开销,SEO 友好,也不怕 JS 被禁用。
- EJS 示例:
<%- include('partials/header') %> - Hugo 示例:
{{ partial "header.html" . }} - 关键区别:这些
include是服务端执行的,和 HTML 原生注释里的#include不是一回事,别混淆 - 容易忽略的一点:路径解析规则各引擎不同,EJS 是相对于
views目录,Hugo 是相对于layouts/partials/,写错就静默失败,不报错
实际选哪条路,取决于你有没有服务端、是否用构建工具、以及是否允许 JS 加载延迟显示。没有银弹,但硬要本地纯 HTML 实现,fetch 方案最直接——只是得记得,所有页面都要加那几行脚本,且不能离线裸跑。
文中关于的知识介绍,希望对你的学习有所帮助!若是受益匪浅,那就动动鼠标收藏这篇《如何将div嵌入所有HTML页面》文章吧,也可关注golang学习网公众号了解相关技术文章。
相关阅读
更多>
-
502 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
最新阅读
更多>
-
343 收藏
-
320 收藏
-
221 收藏
-
410 收藏
-
200 收藏
-
270 收藏
-
319 收藏
-
341 收藏
-
465 收藏
-
239 收藏
-
176 收藏
-
219 收藏
课程推荐
更多>
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习