预加载静态资源

从版本 9.0 开始，您可以在打开文档前将静态资源（HTML、CSS、JS、字体）预加载到浏览器缓存中，以加快文档编辑器首次加载的速度。

预加载有两种方式。

选项 1：使用 ?preload=placeholder 参数

将 ?preload=placeholder 参数附加到 api.js 的 URL 中：

<div id="placeholder"></div>
<script type="text/javascript" src="https://documentserver/web-apps/apps/api/documents/api.js?preload=placeholder"></script>

其中，documentserver 是安装了 ONLYOFFICE 文档的服务器名称。

提示

还没有文档服务器？注册一个免费的 ONLYOFFICE 文档云，并使用实例的公共 IP 地址或公共 DNS 名称作为 documentserver。您可以在云控制台的实例部分找到它们。

加载此脚本时，除了提供 DocsAPI.DocEditor 构造函数之外，脚本还会自动在 id="placeholder" 的元素中插入一个隐藏的 <iframe>，以在后台预加载编辑器的静态资源。

选项 2：手动插入预加载 iframe

另一种方法是，您可以手动插入一个指向预加载页面的隐藏 <iframe>：

<iframe src="https://documentserver/web-apps/apps/api/documents/preload.html" style="display:none;"></iframe>

其中，documentserver 是安装了 ONLYOFFICE 文档的服务器名称。

如果您需要为 iframe 设置额外的安全参数，或在将其插入 DOM 时使用 nonce，建议使用此方法。

备注

使用 <iframe> 来进行预加载，而不是 <link rel="prefetch">。编辑器的静态资源（脚本、样式、字体）会在 iframe 的上下文中加载，而 <link rel="prefetch"> 则无法正确触发静态资源的加载或缓存。