首页
/ QueryLoader2 技术文档

QueryLoader2 技术文档

2024-12-24 09:18:32作者:伍霜盼Ellen

1. 安装指南

使用npm安装

在您的项目中,首先需要通过npm安装QueryLoader2:

npm install queryloader2 --save-dev

使用bower安装

您也可以使用bower来安装QueryLoader2:

bower install queryloader2

2. 项目使用说明

QueryLoader2 的主要功能是在您的网站加载时,通过显示一个覆盖层和加载条来预加载图片。它能够自动检索所有的图片以及背景图片,并在展示网页前预加载它们。

基本用法

在您的网页的 <head> 部分包含 queryloader2.min.js 脚本:

<script src="queryloader2.min.js" type="text/javascript"></script>

创建一个 QueryLoader2 对象,例如:

window.addEventListener('DOMContentLoaded', function() {
    QueryLoader2(document.querySelector("body"), {
        barColor: "#efefef",
        backgroundColor: "#111",
        percentage: true,
        barHeight: 1,
        minimumTime: 200,
        fadeOutTime: 1000
    });
});

使用jQuery

首先在头部包含jQuery和queryloader2.min.js脚本:

<script src="https://code.jquery.com/jquery-1.11.1.min.js" type="text/javascript"></script>
<script src="queryloader2.min.js" type="text/javascript"></script>

然后在 $(document).ready() 中调用 QueryLoader:

$(document).ready(function () {
    $("body").queryLoader2();
});

3. 项目API使用文档

以下为 QueryLoader2 的配置选项:

  • backgroundColor: 加载器的背景颜色(十六进制)。
  • barColor: 加载条的颜色(十六进制)。
  • barHeight: 加载条的高度,单位像素。
  • minimumTime: 加载必须运行的时间,单位毫秒。即使动画完成,如果没有经过这个时间,它仍然会显示。
  • maxTime: 加载器的最长时间,单位毫秒。超过这个时间,加载器将自动关闭。
  • fadeOutTime: 覆盖层淡出所需的时间,单位毫秒。
  • deepSearch: 如果设置为 true,QueryLoader 会搜索所有选定的元素中的图片。如果您不想让 QueryLoader 检查子元素,请设置为 false。
  • percentage: 如果设置为 true,将显示百分比。
  • onComplete: 当加载和动画完成后调用的函数。
  • onProgress: 当加载一张图片时调用的函数,参数包括 percentageimagesLoadedtotalImages

4. 项目安装方式

请参考上述的“安装指南”部分来获取通过npm或bower安装QueryLoader2的详细信息。

热门项目推荐
相关项目推荐

项目优选

收起
HarmonyOS-ExamplesHarmonyOS-Examples
本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
256
63
mybatis-plusmybatis-plus
mybatis 增强工具包,简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.com
Java
19
0
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
175
42
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
49
39
open-eBackupopen-eBackup
open-eBackup是一款开源备份软件,采用集群高扩展架构,通过应用备份通用框架、并行备份等技术,为主流数据库、虚拟化、文件系统、大数据等应用提供E2E的数据备份、恢复等能力,帮助用户实现关键数据高效保护。
HTML
73
54
RuoYi-Cloud-Vue3RuoYi-Cloud-Vue3
🎉 基于Spring Boot、Spring Cloud & Alibaba、Vue3 & Vite、Element Plus的分布式前后端分离微服务架构权限管理系统
Vue
26
18
redis-sdkredis-sdk
仓颉语言实现的Redis客户端SDK。已适配仓颉0.53.4 Beta版本。接口设计兼容jedis接口语义,支持RESP2和RESP3协议,支持发布订阅模式,支持哨兵模式和集群模式。
Cangjie
406
46
advanced-javaadvanced-java
Advanced-Java是一个Java进阶教程,适合用于学习Java高级特性和编程技巧。特点:内容深入、实例丰富、适合进阶学习。
JavaScript
397
102
HarmonyOS-Cangjie-CasesHarmonyOS-Cangjie-Cases
参考 HarmonyOS-Cases/Cases,提供仓颉开发鸿蒙 NEXT 应用的案例集
Cangjie
55
2
RuoYi-VueRuoYi-Vue
🎉 基于SpringBoot,Spring Security,JWT,Vue & Element 的前后端分离权限管理系统,同时提供了 Vue3 的版本
Java
168
37