OnceIO(Node.JS)的网页(模板)的引用与深层嵌套
发布于 6 个月前 作者 onceair 531 次浏览 来自 分享

OnceIO是OnceDoc企业私有内容(网盘)管理系统的底层Web框架，它可以实现模板文件、静态文件的全缓存，运行起来完全不需要I/O操作，并且支持客户端缓存优化，GZIP压缩等（只压缩一次），拥有非常好的性能，为您节约服务器成本。它的模块化功能，可以让你的Web进行分布式存储，在一个扩展包里即可包含前端、后端和数据库定义，只需通过添加/删除目录的方式就可实现功能删减，实现真正的模块化扩展。目前OnceIO已经开源，这里是介绍如何使用的一系列文章。

OnceIO 提供将一个网页文件嵌套在另一个网页文件中的机制。文件嵌套与模板引擎无关，支持所有模板引擎，并支持模板的深层嵌套。语法固定为 <!–#include=“path”–> ，其中 path 为文件相对路径，引号必须为双引号，中间不能有空格。以 index.html 的代码为例：

<!DOCTYPE html>
<html>
<body>
  <!--#include="header.html"--> 
  <div> 
    Main content 
  </div>
  <!--#include="footer.html"--> 
</body>
</html>

这段代码将 header.html 和 footer.html 两个网页文件嵌套在 index.html 中。用户访问 index.html 时，header.html 和 footer.html 也会被同时加载，其中的元素将显示在网页的相应位置。

header.html 代码为：

<div>
  <center>
    Header
  </center>
  <hr>
</div>

footer.html 代码为：

<div class='footer'>
  <hr>
  <center>
    Footer
  </center>
</div>

index.html 显示效果为：

index.html 显示效果

嵌套的层数理论上是没有限制的，被嵌套网页也能嵌套其它网页，但互相循环嵌套可能会造成问题。例如，如果在 header.html 中嵌套 index.html，而index.html又嵌套了header，则index.html 显示效果为：

互相嵌套时 index.html 显示效果

使用网页嵌套时，服务器需要时间加载所有被嵌套网页，因此用户第一次访问时浏览器可能无法显示被嵌套网页的内容，刷新后才能显示完整网页，OnceIO 内置的 preload 方法能解决这个问题。对当前目录下的 html 后缀的文件使用 preload 的示例代码如下：

app.preload('.', '.html')

preload 的第一个参数是相对路径，示例中的 ‘.’ 代表 home 路径，home 是 OnceIO 应用程序的一个属性，它的值可以在定义应用程序时设置，默认值为 ‘./’，即当前目录；第二个参数是文件类型，示例中的 ‘.html’ 代表 html 后缀的网页文件。

使用 preload 后，服务器会提前加载网页文件并将其缓存在服务器内存中，用户第一次访问时无需刷新即可看到完整网页。

OnceIO项目: https://github.com/OnceDoc/onceio 示例源码：https://github.com/OnceDoc/OnceAcademy/tree/master/Lesson10 原文地址：http://cn.oncedoc.com/blog/view/ivi41td7qi9l

回到顶部