Skip to content

全局 Loading

全局 Loading 指的是页面刷新时出现的加载效果,通常是一个旋转的图标。

原理

vite-plugin-app-loading 插件实现,插件会在每个应用注入一个全局的 loading.html

关闭

如果你不需要全局 Loading,可以在 .env 文件中关闭:

bash
VITE_APP_LOADING = false

自定义

如果你想要自定义全局 Loading,可以在应用目录下,与 index.html 同级,创建一个 loading.html 文件,插件会自动读取并注入。这个html可以自行定义样式和动画。

提示

  • 你可以使用跟 index.html 一样的语法,比如 VITE_APP_TITLE 变量,来获取应用的标题。
  • 必须保证有一个 id="__app-loading__" 的元素。
  • id="__app-loading__" 的元素,加一个 hidden class。
  • 必须保证有一个 style[data-app-loading="inject-css"] 的元素。
html
<style data-app-loading="inject-css">
  #__app-loading__.hidden {
    pointer-events: none;
    visibility: hidden;
    opacity: 0;
    transition: all 0.3s ease-out;
  }
  /* ... */
</style>

<div id="__app-loading__">
  <!-- ... -->
  <div class="title"><%= VITE_APP_TITLE %></div>
</div>