微信小程序实现图片预加载组件

发布时间 - 2026-01-10 22:36:11    点击率:

网页中的图片预加载

图片预加载对图片画廊及图片占据很大比例的网站来说十分有利,它保证了图片快速、无缝地发布,也可帮助用户在浏览你网站内容时获得更好的用户体验。我们知道在 Web 页面中实现图片的预加载其实很简单,通常的做法是在 JS 中使用 Image 对象即可,代码大致如下

var image = new Image()
image.onload = function() {
 console.log('图片加载完成')
}
image.src = 'http://misc.360buyimg.com/lib/img/e/logo-201305.png'

下面推荐几篇网页中实现图片预加载的文章:

     1、jquery 图片预加载 自动等比例缩放插件

     2、JS实现图片预加载无需等待

     3、jQuery简单实现图片预加载

然而在微信小程序(以下简称小程序)里要实现图片的预加载要更麻烦一些,因为小程序里并没有提供类似 Image 这样的 JS 对象。。

小程序必知必会

在进入正题前,需要了解以下小程序相关的知识(当然最好还是完整的学习一下官方文档):

  1. 小程序框架的核心是一个响应的数据绑定系统,整个系统分为视图层和逻辑层两块,视图层即页面模板(后缀为 .wxml 的文件),逻辑层即页面 JS 文件
  2. 小程序的页面模板由一系列的基础组件组合而成,如 view、text、button 等
  3. 页面内容的更新基于数据的单向绑定来进行,通过 JS 调用 Page 对象的 setData 方法来更新模板中绑定的数据
  4. 视图层到逻辑层的通信是通过事件完成的,在组件中声明事件的回调,JS 端可监听到界面交互的发生、组件状态的变化等
  5. 在 WXML 文件中,可通过 template 进行模板的复用,若 template 是在不同文件里定义的,需要先通过 import 语句进行引入

这里有个官方的简单例子可以用来帮助理解

<!-- 模板文件 foo.wxml -->
<view> Hello {{name}}! </view>
<button bindtap="changeName"> Click me! </button>
//脚本文件 foo.js
Page({
 data: {
 name: 'WeChat'
 },
 changeName: function(e) {
 this.setData({
 name: 'MINA'
 })
 }
})

运行这个页面会看到一行 Hello WeChat! 的文字及一个按钮,点击按钮后文字会变成 Hello MINA!

在小程序中加载图片

小程序提供一个 image 组件(类似于 HTML 中的 img 标签),可以设置 src 及加载成功或失败的回调,使用起来很简单

<!-- 模板文件 bar.wxml -->
<image src="http://misc.360buyimg.com/lib/img/e/logo-201305.png" bindload="imageOnLoad" binderror="imageOnLoadError" />
//脚本文件 bar.js
Page({
 imageOnLoad(ev) {
 console.log(`图片加载成功,width: ${ev.detail.width}; height: ${ev.detail.height}`)
 },
 imageOnLoadError() {
 console.log('图片加载失败')
 }
})

运行以上代码,顺利的话页面上会显示出一张图片,同时控制台会打印出带图片宽高的日志信息

将功能抽离成公用组件

接下来我们考虑实现这么一个功能,在页面上载入一张尺寸和 K 数都很大的图片,由于图片很大,下载需要一定的时间,而在这段时间内,用户看到的是空白或是不完整的图片,体验显然不好。

一种常用的优化手段是先加载一张缩略图,该缩略图通过样式设置为和原图一样的宽高,这样用户首先能很快速地看到一张模糊的图片,此时再去对原图做预加载,加载完成之后对缩略图进行替换,因为此时图片已经下载过了,所以界面上能无缝地切换为原图显示,效果如下:

单张图片预加载

完成这个优化操作的关键就在于需要一个公共的图片预加载组件的支持,接下来我们分步骤来看看如何实现

  1. 新建 demo 页面及组件相关的文件 img-loader.js 和 img-loader.wxml,组件需要和页面一样有个模板文件,是因为小程序里无法动态地插入模板结构。然后在 demo.wxml 里通过 import 语句引用组件模板,在 demo.js 里通过 require 语句将组件脚本进行引入
  2. 在页面中通过 template 调用组件模板并传入数据,这里我们传递一个名为 imgLoadList 的图片数组过去
  3. 在页面脚本中的 onLoad 方法中对组件进行初始化,并将 this 对象传入,因为组件内必须通过 Page 对象的 setData 来更新模板里的内容
  4. 在组件的 img-loader.js 中定义一个 load 方法用来创建一个图片的加载,将传入的 src 添加到加载队列中,并使用 setData 方法更新队列数据
  5. 接下来在组件 img-loader.wxml 中通过接收到的图片队列数据,用 wx:for 指令去生成 image 组件来对图片进行加载,同时将成功及失败的回调绑定到 img-loader.js 中的方法中,最终再回调回 Page 对象中

可以看出,由于小程序里无法动态地插入模板结构,所以相对于普通网页端的组件调用,这里多出了在 WXML 文件中引入及使用模板这个步骤,而其他部分对于调用方(即Demo 页面)来说则是相似的,下面是完整的 Demo 页面的代码

<!-- demo.wxml -->
<view class="img_wrap">
 <image wx:if="{{ imgUrl }}" src="{{ imgUrl }}" />
</view>
<button bindtap="loadImage">Click To Load Image</button>
<view class="msg">{{ msg }}</view>
<!-- 引入图片预加载组件 -->
<import src="../../img-loader/img-loader.wxml"/>
<template is="img-loader" data="{{ imgLoadList }}"></template>
// ------ demo.js ------
//引入图片预加载组件
const ImgLoader = require('../../img-loader/img-loader.js')
//缩略图 80x50 3KB
const imgUrlThumbnail = 'http://storage.360buyimg.com/mtd/home/lion1483683731203.jpg'
//原图 3200x2000 1.6MB
const imgUrlOriginal = 'http://storage.360buyimg.com/mtd/home/lion1483624894660.jpg'
Page({
 data: {
 msg: '',
 imgUrl: ''
 },
 onLoad() {
 //初始化图片预加载组件
 this.imgLoader = new ImgLoader(this)
 },
 loadImage() {
 //加载缩略图
 this.setData({
 msg: '大图正拼命加载..',
 imgUrl: imgUrlThumbnail
 })
 //同时对原图进行预加载,加载成功后再替换
 this.imgLoader.load(imgUrlOriginal, (err, data) => {
 console.log('图片加载完成', err, data.src)
 this.setData({ msg: '大图加载完成~' })
 if (!err)
 this.setData({ imgUrl: data.src })
 })
 }
})

如果把图片加载完成的回调统一指定成 Page 对象中的方法,则可以很方便地处理多张图片的加载,这里也写了个例子,效果如下:

多张图片预加载

总的来说调用起来还算方便吧,img-loader 的组件代码略多这里就不贴出来啦,有兴趣的同学可以前往 Github 项目页面 查看,目前此组件已应用在京东购物小程序版中。

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作能带来一定的帮助,如果有疑问大家可以留言交流。


# 微信小程序图片预加载  # 微信小程序自定义组件  # 微信小程序组件  # 微信小程序 radio单选框组件详解及实例代码  # 微信小程序picker组件下拉框选择input输入框的实例  # 微信小程序 Button 组件详解及简单实例  # 微信小程序 倒计时组件实现代码  # 微信小程序 swiper组件轮播图详解及实例  # 详解如何在微信小程序开发中正确的使用vant ui组件  # 微信小程序(十)swiper组件详细介绍  # 微信小程序(十四)button组件详细介绍  # 微信小程序 Image组件实例详解  # 微信小程序开发之组件设计规范  # 加载  # 绑定  # 回调  # 是在  # 有个  # 多张  # 象中  # 的是  # 是一个  # 是因为  # 过了  # 就不  # 则是  # 而在  # 也可  # 这段  # 时间内  # 而成  # 很简单  # 并将 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: Laravel如何使用Scope本地作用域_Laravel模型常用查询逻辑封装技巧【手册】  Python自动化办公教程_ExcelWordPDF批量处理案例  如何用PHP工具快速搭建高效网站?  Laravel如何实现多语言支持_Laravel本地化与国际化(i18n)配置教程  Laravel N+1查询问题如何解决_Eloquent预加载(Eager Loading)优化数据库查询  Laravel如何实现图片防盗链功能_Laravel中间件验证Referer来源请求【方案】  如何快速登录WAP自助建站平台?  javascript如何操作浏览器历史记录_怎样实现无刷新导航  高端建站如何打造兼具美学与转化的品牌官网?  如何在万网开始建站?分步指南解析  php打包exe后无法访问网络共享_共享权限设置方法【教程】  Laravel如何自定义分页视图?(Pagination示例)  canvas 画布在主流浏览器中的尺寸限制详细介绍  Laravel如何生成PDF或Excel文件_Laravel文档导出工具与使用教程  如何自定义建站之星模板颜色并下载新样式?  如何快速辨别茅台真假?关键步骤解析  Laravel怎么实现模型属性转换Casting_Laravel自动将JSON字段转为数组【技巧】  JS中使用new Date(str)创建时间对象不兼容firefox和ie的解决方法(两种)  HTML5空格和margin有啥区别_空格与外边距的使用场景【说明】  javascript中的try catch异常捕获机制用法分析  Laravel的路由模型绑定怎么用_Laravel Route Model Binding简化控制器逻辑  Laravel如何生成API文档?(Swagger/OpenAPI教程)  Laravel模型事件有哪些_Laravel Model Event生命周期详解  Claude怎样写结构化提示词_Claude结构化提示词写法【教程】  高防服务器如何保障网站安全无虞?  深圳网站制作公司好吗,在深圳找工作哪个网站最好啊?  BootStrap整体框架之基础布局组件  Laravel如何与Docker(Sail)协同开发?(环境搭建教程)  LinuxShell函数封装方法_脚本复用设计思路【教程】  昵图网官方站入口 昵图网素材图库官网入口  Android利用动画实现背景逐渐变暗  简历没回改:利用AI润色让你的文字更专业  UC浏览器如何切换小说阅读源_UC浏览器阅读源切换【方法】  专业型网站制作公司有哪些,我设计专业的,谁给推荐几个设计师兼职类的网站?  Laravel怎么在Controller之外的地方验证数据  大连企业网站制作公司,大连2025企业社保缴费网上缴费流程?  php静态变量怎么调试_php静态变量作用域调试技巧【解答】  微信小程序 配置文件详细介绍  JS中页面与页面之间超链接跳转中文乱码问题的解决办法  Laravel Fortify是什么,和Jetstream有什么关系  详解jQuery停止动画——stop()方法的使用  Laravel Seeder怎么填充数据_Laravel数据库填充器的使用方法与技巧  Laravel中间件起什么作用_Laravel Middleware请求生命周期与自定义详解  在线制作视频网站免费,都有哪些好的动漫网站?  网易LOFTER官网链接 老福特网页版登录地址  Laravel Telescope怎么调试_使用Laravel Telescope进行应用监控与调试  使用豆包 AI 辅助进行简单网页 HTML 结构设计  如何在橙子建站上传落地页?操作指南详解  成都网站制作公司哪家好,四川省职工服务网是做什么用?  uc浏览器二维码扫描入口_uc浏览器扫码功能使用地址