deploy

.vitepress/config.ts

@@ -159,6 +159,7 @@ _hmt.push(['_requirePlugin', 'UrlChangeTracker', {
             { text: '标准模块', link: '/guide/plop-module' },
             { text: '常用 API', link: '/guide/api' },
             { text: '私有 Storage 数据', link: '/guide/storage' },
+            { text: '首屏 Loading', link: '/guide/loading' },
             { text: '页面水印', link: '/guide/watermark' },
             { text: '错误日志', link: '/guide/error-log' },
             { text: '自定义字体', link: '/guide/font' },

guide/loading.md

@@ -0,0 +1,13 @@
+# 首屏 Loading
+
+首屏 Loading 是指首次访问页面，在页面上空白的等待时间时，会展示一个 Loading 动画，直到页面加载完成。
+
+![](/loading.png){data-zoomable}
+
+## 自定义
+
+直接修改根目录下的 `/loading.html` 文件即可，你可以从 [CSS Loaders](https://css-loaders.com/) 网站中找找灵感，它提供了 600+ 个纯 CSS 的加载动画。
+
+## 原理
+
+框架会自动读取 `/loading.html` 文件内容并在 Vite 构建前注入到 `/index.html` 中，所以它也支持 Vite 的 [HTML 环境变量替换](https://cn.vitejs.dev/guide/env-and-mode.html#html-env-replacement)。