如何将div嵌入所有HTML页面
2026-02-18 12:00:48
0浏览
收藏
浏览器原生不支持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 片段: - 在每个页面底部加一段脚本:
- 对应页面中预留挂载点:
- 注意路径是相对当前 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: '' } })] }) - 然后在
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学习网公众号了解相关技术文章。
PHP协程优化性能实战教程
- 上一篇
- PHP协程优化性能实战教程
- 下一篇
- Win10截图方法与快捷键汇总
查看更多
最新文章
-
- 文章 · 前端 | 3天前 | 前端 · 性能优化 · css · Core Web Vitals · 渲染性能 · 前端 渲染性能 CSS性能 CLS content-visibility contain-intrinsic-size Layout
- 前端长页面渲染卡顿怎么排查:用 content-visibility 跳过离屏区块
- 430浏览 收藏
-
- 文章 · 前端 | 1星期前 | 前端 · javascript · AbortController · 表单提交 · AbortController 旧响应覆盖 前端重复提交 loading锁 fetch取消 按钮防抖
- 前端按钮重复提交怎么办:loading 锁和 AbortController 最小配方
- 442浏览 收藏
-
- 文章 · 前端 | 1星期前 | 前端 · 缓存 · Service Worker · 白屏 · 发布故障 · 缓存策略 前端白屏 Service Worker CacheStorage 资源404 发布回滚
- 前端发布后白屏复盘:Service Worker 缓存旧入口导致 JS 资源 404
- 469浏览 收藏
-
- 文章 · 前端 | 1星期前 | 前端开发 · localStorage · 表格配置 · 用户偏好 · 后台系统 · 用户偏好 localStorage 前端表格 列配置 可见列 列宽保存
- 前端表格列设置刷新后丢失怎么办:可见列、列宽和顺序这样保存
- 351浏览 收藏
-
- 文章 · 前端 | 1星期前 | 前端 · 接口排查 · 运维手册 · 性能告警 · 前端 AbortController 接口超时 Network瀑布图 降级回滚 线上告警
- 前端接口超时告警运行手册:从瀑布图到降级回滚
- 287浏览 收藏
查看更多
课程推荐
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
查看更多
AI推荐
-
- ljg-skills
- ljg-skills 是李继刚开源的 AI 技能与提示词集合,面向大模型使用者整理了一批可复用的 prompt、角色设定和任务技能模板,适合用于学习提示词设计、搭建个人 AI 工作流和沉淀团队常用智能体能力。
- 4415次使用
-
- MELO音乐
- MELO音乐是一站式AI视频与音乐制作助手,对标suno, udio的高品质体验。提供伴奏生成、原创写词、无损导出、哼唱识曲、混音变声等全套音频与短视频编辑工具。无论是流行Kpop、电音说唱、民谣古风、摇滚儿歌还是商用轻音乐,MELO为你免费谱曲,轻松做同款!
- 4075次使用
-
- UniScribe
- UniScribe 是一款 AI 音视频转文字与内容整理工具,支持上传音频、视频文件或粘贴 YouTube 链接,自动生成转写文本、摘要、思维导图和关键问题,并支持多格式导出,适合会议记录、课程学习、访谈整理和内容创作复盘。
- 4058次使用
-
- 剧云
- 剧云是专业中文剧本创作平台,安全稳定运行十余年,集成AI编剧、剧本医生审核、人物小传、剧情关系图、大纲编写、多人协作、Word导入导出、版权管控功能,数据安全防护,轻松高效创作剧本。
- 4242次使用
-
- 万象有声
- 万象有声,一个专为有声创作者打造的新一代智能有声内容创作平台。平台提供专业的智能拆章、智能画本编辑、AI配音、AI生成音效、后期制作、智能对轨、智能审听等有声创作全流程工具,可以帮助创作者高效、低成本创作出引人入胜的有声作品。立即体验,让有声书制作更简单!
- 4217次使用
查看更多
相关文章
-
- JavaScript函数定义及示例详解
- 2025-05-11 502浏览
-
- CSS变量简化按钮悬停效果技巧
- 2026-05-31 501浏览
-
- JavaScript符号类型详解与应用
- 2026-05-31 501浏览
-
- HTML剪贴板复制粘贴怎么用
- 2026-05-26 501浏览
-
- data-*属性详解:HTML数据存储与DOM操作技巧
- 2026-05-25 501浏览

