如何在纯 HTML 站点中动态加载外部页眉(Header)文件

大明酱_6007

大明酱_6007

2026-07-01

1012人浏览

原创

如何在纯 HTML 站点中动态加载外部页眉(Header)文件

本文介绍一种无需服务器端语言(如 php)、不依赖废弃的 html import,仅用原生 javascript 实现页眉/页脚复用的方法:通过 fetch() 加载外部 html 片段并注入 dom,适用于 .html 后缀站点。

本文介绍一种无需服务器端语言(如 php)、不依赖废弃的 html import,仅用原生 javascript 实现页眉/页脚复用的方法:通过 fetch() 加载外部 html 片段并注入 dom,适用于 .html 后缀站点。

在构建多页面静态网站(如影院管理系统)时,重复维护相同页眉与页脚极易导致代码冗余与更新不一致。若无法使用 PHP 的 include 或服务端模板引擎,且 HTML5 已被主流浏览器弃用,基于 Fetch API 的客户端动态注入是最实用、兼容性良好(支持现代浏览器)的解决方案。

✅ 推荐实现方式:Fetch + DOM 插入

核心思路:将页眉 HTML 抽离为独立文件(如 header.html),在主页面中预留占位容器,并通过 JavaScript 异步加载内容后插入。

1. 创建独立页眉文件(header.html)

注意:该文件仅包含 HTML 片段,无需 、

使用华数设计生成高保真HTML原型、演示文稿、动画和设计评审
使用华数设计生成高保真HTML原型、演示文稿、动画和设计评审

使用经过文档化的设计技能,从真实的品牌或项目背景中生成HTML原生原型、幻灯片、动态演示、可视化图表和评审流程。

下载
或 标签:
<header class="header"><nav class="navigation-open"><div class="global container grid-x">
      <div class="logowrapper grid-x">
        <div class="logo-container">
          <a href="index.html">
            @@##@@
          </a>
        </div>
      </div>
      <div class="dashboard-nav cell grid-x">
        <nav class="choicewrapper"><ul class="wrapper">
<li class="page-cinema"><a href="#" class="gradient-fill-hover"><span>A</span><span>l</span><span> </span><span>C</span><span>i</span><span>n</span><span>e</span><span>m</span><span>a</span></a></li>
            <li class="page-card"><a href="#" class="gradient-fill-hover"><span>C</span><span>a</span><span>r</span><span>d</span><span> </span><span>e</span><span> </span><span>P</span><span>r</span><span>o</span><span>m</span><span>o</span></a></li>
            <li class="page-pass"><a href="#" class="gradient-fill-hover"><span>P</span><span>a</span><span>s</span><span>s</span></a></li>
          </ul></nav>
</div>
      <nav class="loginwrapper grid-x cell align-right"><div class="form-search-s grid-x">
          <form class="form-search" onsubmit="event.preventDefault();" role="search">
            <label for="search">Search for stuff</label>
            <input class="input-search" type="search" id="search" placeholder="Search..." autofocus required><button type="submit" class="btn-search">Go</button>
          </form>
        </div>
        <div class="profile-login">
          <a href="../login/login.html" title="Accedi / Registrati">
            <i class="fas fa-user"></i><span>Login</span><i class="fas fa-caret-down"></i>
          </a>
          <!-- 下拉菜单逻辑建议移至独立 JS 控制,此处保持结构简洁 -->
        </div>
      </nav>
</div>
  </nav></header>

2. 在主页面中声明占位符并加载

在任意 .html 页面(如 index.html)的

中插入占位元素,并在底部引入加载脚本(确保 DOM 已就绪):


  <meta charset="utf-8"><title>Cate Cinema</title><!-- 其他 CSS 和字体链接保持不变 --><!-- 占位容器:用于注入页眉 --><div id="header-placeholder"></div>

  <!-- 主要内容区域 -->
  <main id="content"><h1>Welcome to Cate Cinema</h1>
    <!-- 此处放置页面特有内容 -->
  </main><!-- 脚本置于 body 底部,确保 DOM 可访问 --><script>
    // 使用 fetch 动态加载 header.html 并插入
    document.addEventListener('DOMContentLoaded', () => {
      fetch('../header/header.html')
        .then(response => {
          if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
          return response.text();
        })
        .then(html => {
          document.getElementById('header-placeholder').innerHTML = html;
        })
        .catch(err => {
          console.error('Failed to load header:', err);
          // 可选:提供降级提示或内联默认 header
          document.getElementById('header-placeholder').innerHTML = 
            '<header class="header"><h2>Header Loading Failed';
        });
    });
  </script>

⚠️ 关键注意事项

  • CORS 限制:fetch() 默认受同源策略约束。若本地直接双击打开 HTML 文件(file:// 协议),浏览器会阻止跨文件读取。必须通过本地服务器运行(如 VS Code Live Server、npx serve 或 Python http.server)。
  • 错误处理不可省略:网络失败或路径错误时应提供 fallback,避免页面空白。
  • SEO 与初始渲染:纯客户端注入的内容不会被搜索引擎爬虫立即抓取(需考虑 SSR 或预渲染方案提升 SEO)。
  • 样式与脚本隔离:header.html 中不应包含
  • 复用页脚同理:只需复制逻辑,创建 footer.html 并使用 #footer-placeholder 即可。

✅ 总结

该方案以零服务端依赖、最小侵入性、良好可维护性,解决了静态 HTML 站点组件复用的核心痛点。它不依赖过时标准,符合现代 Web 开发实践,是中小型项目快速落地页眉/页脚模块化的可靠选择。

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

7495

7

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

2023.06.21

4112

4

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.31

3790

5

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.01

3799

5

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2023.08.11

5259

6

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

2023.08.11

3721

3

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

3549

3

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2023.09.01

3048

6

HTML嵌入CSS样式的方法
HTML嵌入CSS样式的方法

HTML嵌入CSS样式的方法有内联样式、内部样式表和外部样式表。本专题为大家提供CSS样式相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.20

3228

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.5万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.8万人学习