如何在纯静态 HTML 中无服务器地模块化加载其他 HTML 文件

霞舞

霞舞

2026-08-04

999人浏览

原创

如何在纯静态 HTML 中无服务器地模块化加载其他 HTML 文件

本文介绍一种无需后端、不依赖第三方工具,仅用原生 HTML/CSS 即可在本地双击打开时自动内嵌加载多个子 HTML 文件的可靠方案,并解释为何直接使用 fetch() 会失败及替代解法。

本文介绍一种无需后端、不依赖第三方工具,仅用原生 html/css 即可在本地双击打开时自动内嵌加载多个子 html 文件的可靠方案,并解释为何直接使用 `fetch()` 会失败及替代解法。

在纯静态环境下(即双击 .html 文件直接用浏览器打开),实现模块化 HTML 内容复用面临一个关键限制:浏览器的同源策略(CORS)会阻止 fetch() 或 XMLHttpRequest 直接读取本地文件系统中的其他 HTML 文件。你提供的 JavaScript 示例在 Chrome、Edge 等现代浏览器中必然失败,报错类似 Failed to fetch: Origin 'null' is not allowed by Access-Control-Allow-Origin——这不是代码写法问题,而是安全机制的硬性约束,无法绕过(除非启动本地服务器或修改浏览器启动参数,但这违背“开箱即用”需求)。

因此,唯一符合全部约束条件(无服务、无第三方、无 PHP/SSI、不依赖 iframe 滚动条)的可行方案是:使用 。虽然你曾尝试 iframe 并遇到滚动条问题,但通过现代 CSS 可彻底解决:

✅ 推荐方案:自适应高度 iframe(零 JavaScript,完全静态)



    <meta charset="UTF-8"><title>主文档 - 模块化笔记</title><style>
        * { margin: 0; padding: 0; box-sizing: border-box; }
        body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; }
        iframe {
            width: 100%;
            min-height: 300px;
            height: calc(100vh - 60px); /* 预留标题/导航空间 */
            border: none;
            overflow: hidden;
        }
        /* 关键:隐藏 iframe 默认滚动条,并确保内容撑满 */
        iframe::-webkit-scrollbar { display: none; }
        iframe { -ms-overflow-style: none;  scrollbar-width: none; }
    </style><h1>我的模块化笔记</h1>
    <!-- 加载第一个子模块 -->
    <iframe src="sub-file.html"></iframe>

    <!-- 可继续追加更多模块(按需顺序排列) -->
    <!-- <iframe src="section-2.html"></iframe> -->
    <!-- <iframe src="references.html"></iframe> -->

优势说明

  • 完全静态:双击即运行,兼容所有现代浏览器(Chrome/Firefox/Safari/Edge);
  • 无滚动条:height: calc(100vh - 60px) 动态分配视口高度,配合 overflow: hidden 彻底隐藏滚动条;
  • 内容无缝衔接:每个 iframe 独立渲染,但视觉上连续呈现(注意:子文件中避免 重复结构,推荐子文件仅保留语义化内容,如

    章节标题

    正文...

    );
  • 可扩展性强:只需新增

⚠️ 注意事项与最佳实践

  • 子文件结构优化:sub-file.html 应为「片段式 HTML」,不要包含 , , 标签,仅保留实际内容:

    使用HTML,CSS,JavaScript开发Android应用程序 英文文字pdf版附源文件
    使用HTML,CSS,JavaScript开发Android应用程序 英文文字pdf版附源文件

    如果你了解HTML,CSS和JavaScript,您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造,可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Andr​​oid友好的网络应用程序,然后转换与自由PhoneGap框架到一个原生的Andr​​oid应用程序。了解为什么设备无关的移动应用是未来的潮流,并开始构建应用程序,提供更

    下载
    <!-- sub-file.html(正确写法) -->
    <p>Hello World</p>
    
    • 知识点一
    • 知识点二

    若包含完整 HTML 结构,将导致嵌套文档混乱,且可能触发 iframe 内部滚动条。

  • 路径必须相对且同目录:确保 main-file.html 与 sub-file.html 在同一文件夹下,或使用正确的相对路径(如 ./sections/sub-file.html)。

  • 跨域风险提示:若未来需从不同域名或协议(如 file:// → https://)加载,iframe 同样受同源策略限制,此时必须部署简易本地服务器(如 Python 的 python -m http.server),但本方案已满足“纯本地双击运行”核心诉求。

✅ 替代思路验证(不推荐但供参考)

  • ❌ fetch() + file://:不可行,CORS 是浏览器强制拦截,无例外;
  • :兼容性差,部分浏览器渲染异常且同样受 CORS 影响;
  • ❌ document.write() 动态写入:仅适用于同文档内联内容,无法读取外部文件。

综上,。它将你的笔记自然拆分为多个可独立编辑的 .html 文件,同时保持主页面整洁统一——真正实现“所见即所得”的静态模块化写作体验。

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

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

2389

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

718

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

2205

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

638

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1167

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

2111

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

2392

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

1499

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

500

7

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
HTML 代码实例
HTML 代码实例

共27课时 | 16.4万人学习