0

0

如何修复页面预加载器(Preloader)无法自动隐藏的问题

心靈之曲

心靈之曲

发布时间:2026-01-21 10:00:33

|

770人浏览过

|

来源于php中文网

原创

如何修复页面预加载器(Preloader)无法自动隐藏的问题

本文详解预加载器卡在旋转两次后冻结、主页面不显示的常见原因,重点修正 jquery 选择器错误、未调用函数、动画逻辑混乱等问题,并提供可直接运行的完整解决方案。

预加载器(Preloader)本应作为页面资源加载完成前的视觉过渡,但若实现不当,极易出现“无限旋转”“只转两圈就卡住”“主内容始终不显示”等典型问题。你遇到的现象—— spinner 仅旋转两次后冻结、页面白屏——根本原因并非动画本身,而是 JavaScript 执行逻辑存在三处关键缺陷:

  1. 选择器未加引号:$(preloader) 将 preloader 视为未声明的变量,导致 jQuery 报错并中断执行;正确写法是 $('.preloader')(使用类选择器字符串);
  2. 函数未主动调用:fade() 函数定义后未执行,浏览器不会自动运行它,必须显式调用一次(如 fade(););
  3. 错误的 setTimeout 嵌套逻辑:原代码中连续两次 setTimeout(fade, ...) 并非“延迟后执行”,而是立即注册两个定时任务,且 fade() 内部又递归调用自身,造成无限重复淡出(甚至可能触发多次 DOM 操作冲突),最终导致预加载器状态异常或 JS 崩溃。

✅ 正确做法是:监听页面加载完成事件($(document).ready() 或 window.onload),待所有资源加载完毕后,一次性执行 .fadeOut(),而非依赖循环定时器。

以下是修复后的完整、轻量、可靠的实现方案:

Chromox
Chromox

Chromox是一款领先的AI在线生成平台,专为喜欢AI生成技术的爱好者制作的多种图像、视频生成方式的内容型工具平台。

下载
<!-- HTML -->
<div class="preloader">
  <img src="./Images/loading.png" alt="Loading...">
</div>

<!-- 注意:jQuery 版本已更新为稳定版,且 .min.js 后缀拼写修正 -->
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.3/jquery.min.js"></script>
<script>
  $(document).ready(function() {
    // 确保 DOM 加载完成后再执行
    setTimeout(function() {
      $('.preloader').fadeOut('slow', function() {
        // fadeOut 完成后回调:可选地移除元素以释放内存
        $(this).remove();
      });
    }, 800); // 可选:预留短暂动画缓冲(如需更顺滑,可配合 CSS transition)
  });
</script>
/* CSS —— 移除冗余 animation-duration 和未使用的 @keyframes fadeout */
.preloader {
  position: fixed;
  top: 0;
  left: 0;
  width: 100%;
  height: 100vh;
  background-color: #FFA800;
  z-index: 999999; /* 高于所有内容,但避免过度夸张如 100000 */
  display: flex;
  align-items: center;
  justify-content: center;
  transition: opacity 0.4s ease; /* 为 fadeOut 提供平滑基础 */
}

.preloader img {
  width: 150px;
  animation: spin 3s linear infinite; /* 改为 infinite,确保持续旋转直到被移除 */
}

@keyframes spin {
  from { transform: rotate(0deg); }
  to   { transform: rotate(360deg); }
}

? 关键注意事项

  • ✅ 务必检查 <script> 标签中 jQuery 的 URL 是否拼写正确(原代码中 jquery.minjs 应为 jquery.min.js);
  • ✅ 不要将 fadeOut() 放入无条件递归函数中——它不是轮询机制,而是一次性过渡操作
  • ✅ 若页面含大量图片或外部资源,建议结合 window.addEventListener('load', ...) 替代 $(document).ready(),确保所有资源(包括图片)加载完毕后再隐藏 preloader;
  • ✅ 生产环境推荐使用纯 CSS + JavaScript 方案(无需 jQuery),降低依赖;但对初学者,上述 jQuery 方案简洁可靠,便于理解生命周期。

通过以上修正,你的预加载器将在页面完全就绪后平滑淡出,主内容自然呈现——既符合用户体验规范,也体现前端逻辑的严谨性。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
jquery插件有哪些
jquery插件有哪些

jquery插件有jQuery UI、jQuery Validate、jQuery DataTables、jQuery Slick、jQuery LazyLoad、jQuery Countdown、jQuery Lightbox、jQuery FullCalendar、jQuery Chosen和jQuery EasyUI等。本专题为大家提供jquery插件相关的文章、下载、课程内容,供大家免费下载体验。

156

2023.09.12

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

335

2023.10.13

jquery删除元素的方法
jquery删除元素的方法

jquery可以通过.remove() 方法、 .detach() 方法、.empty() 方法、.unwrap() 方法、.replaceWith() 方法、.html('') 方法和.hide() 方法来删除元素。更多关于jquery相关的问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

406

2023.11.10

jQuery hover()方法的使用
jQuery hover()方法的使用

hover()是jQuery中一个常用的方法,它用于绑定两个事件处理函数,这两个函数将在鼠标指针进入和离开匹配的元素时执行。想了解更多hover()的相关内容,可以阅读本专题下面的文章。

515

2023.12.04

jquery实现分页方法
jquery实现分页方法

在jQuery中实现分页可以使用插件或者自定义实现。想了解更多jquery分页的相关内容,可以阅读本专题下面的文章。

312

2023.12.06

jquery中隐藏元素是什么
jquery中隐藏元素是什么

jquery中隐藏元素是非常重要的一个概念,在使用jquery隐藏元素之前,需要先了解css样式中关于元素隐藏的属性,比如display、visibility、opacity等属性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

128

2024.02.23

jquery中什么是高亮显示
jquery中什么是高亮显示

jquery中高亮显示是指对页面搜索关键词时进行高亮显示,其实现办法:1、先获取要高亮显示的行,获取搜索的内容,再遍历整行内容,最后添加高亮颜色;2、使用“jquery highlight”高亮插件。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

183

2024.02.23

jQuery 正则表达式相关教程
jQuery 正则表达式相关教程

本专题整合了jQuery正则表达式相关教程大全,阅读专题下面的文章了解更多详细内容。

51

2026.01.13

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 0.9万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

CSS教程
CSS教程

共754课时 | 42.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号