https://github.com/hooray/vite-plugin-app-loading

Add a loading animation to your website | 给网站添加一个加载动画
https://github.com/hooray/vite-plugin-app-loading

animation loading loading-bar loading-page loading-spinner react spinner vite vue

Last synced: 7 days ago
JSON representation

Add a loading animation to your website | 给网站添加一个加载动画

• Host: GitHub
• URL: https://github.com/hooray/vite-plugin-app-loading
• Owner: hooray
• Created: 2024-09-12T14:41:44.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2024-10-10T02:28:48.000Z (about 1 month ago)
• Last Synced: 2024-11-01T06:42:31.648Z (14 days ago)
• Topics: animation, loading, loading-bar, loading-page, loading-spinner, react, spinner, vite, vue
• Language: HTML
• Homepage: https://www.npmjs.com/package/vite-plugin-app-loading
• Size: 259 KB
• Stars: 6
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.CN.md

Awesome Lists containing this project

README

        
# vite-plugin-app-loading

[![NPM version](https://img.shields.io/npm/v/vite-plugin-app-loading?color=a1b858&label=)](https://www.npmjs.com/package/vite-plugin-app-loading)

[English](./README.md) | **中文**

给网站添加一个加载动画

![vite-plugin-app-loading](https://github.com/user-attachments/assets/95217497-7022-43c1-987a-cec101db7671)

## 安装

```bash

npm i vite-plugin-app-loading -D

```

## 使用

```ts

// vite.config.ts

import AppLoading from 'vite-plugin-app-loading'

export default defineConfig({

  plugins: [

    AppLoading(),

  ],

})

```

在合适的时机隐藏加载动画：

```ts

// src/main.ts

import { loadingFadeOut } from 'virtual:app-loading'

loadingFadeOut()

```

## 类型

有两种方法可以告诉 TypeScript 虚拟导入的类型：

- 在你的 `global.d.ts` 文件添加下面这句：

  ```ts

  /// 

  ```

- 在你的 `tsconfig.json` 中，将以下内容添加到你的 `compilerOptions.types` 数组中：

  ```json

  {

    // ...

    "compilerOptions": {

      // ...

      "types": [

        "vite-plugin-app-loading/client"

      ]

    }

  }

  ```

## 自定义动画

在应用根目录创建 `loading.html` 文件：

```html

.loader {

  font-weight: bold;

  font-family: sans-serif;

  font-size: 30px;

  animation: l1 1s linear infinite alternate;

}

.loader:before {

  content:"Loading..."

}

@keyframes l1 {to{opacity: 0}}



```


```ts

// vite.config.ts

import AppLoading from 'vite-plugin-app-loading'

export default defineConfig({

  plugins: [

    AppLoading('loading.html'),

  ],

})

```

![](https://github.com/user-attachments/assets/b05f8157-2f06-44af-b8bb-fa53701daf29)

> [!TIP]

> 你可以从下列网站中找找灵感，它们都提供了纯 CSS 的加载动画，非常适合搭配本插件一起使用。

>

> - [CSS Loaders](https://css-loaders.com/)

> - [CSS Loader Generator](https://10015.io/tools/css-loader-generator)

> - [Loaders](https://cssloaders.github.io/)

## 范例

[Fantastic-admin](https://github.com/fantastic-admin/basic)

## 致谢

感谢 [vue-vben-admin](https://github.com/vbenjs/vue-vben-admin/tree/7bcb973d6595545e2cef6ad4006d781b3176f67b/internal/vite-config/src/plugins/inject-app-loading) 提供的灵感。