# wxapp-img-loader **Repository Path**: mirrors/wxapp-img-loader ## Basic Information - **Project Name**: wxapp-img-loader - **Description**: wxapp-img-loader 适用于微信小程序的图片预加载组件,已应用于京东购物小程序版 - **Primary Language**: JavaScript - **License**: Not specified - **Default Branch**: master - **Homepage**: https://www.oschina.net/p/wxapp-img-loader - **GVP Project**: No ## Statistics - **Stars**: 3 - **Forks**: 3 - **Created**: 2018-04-03 - **Last Updated**: 2025-09-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # wxapp-img-loader 这是一个适用于微信小程序的原生图片预加载组件(**若你使用的是 [Taro](https://taro.aotu.io/),请移步至 [taro 分支](https://github.com/o2team/wxapp-img-loader/tree/taro)**),已应用于京东购物等多个小程序中。使用步骤如下: 1、将 img-loader 目录拷贝到你的项目中 2、在页面的 WXML 文件中添加以下代码,将组件模板引入 ```html ``` 3、在页面的 JS 文件中引入组件脚本 ```js const ImgLoader = require('../../img-loader/img-loader.js') ``` 4、实例化一个 ImgLoader 对象,将 this(当前 Page 对象) 传入,第二个参数可选,为默认的图片加载完成的回调方法 ```js this.imgLoader = new ImgLoader(this) ``` 5、调用 ImgLoader 实例的 load 方法进行图片加载,第一个参数为图片链接,第二个参数可选,为该张图片加载完成时的回调方法 ```js this.imgLoader.load(imgUrlOriginal, (err, data) => { console.log('图片加载完成', err, data.src, data.width, data.height) }) ``` 注:图片加载完成的回调方法的第一个参数为错误信息(加载成功则为 null),第二个参数为图片信息(Object 类型,包括 src、width 及 height)。 使用方法可参考 demo 目录的事例,包括加载单张图片、及加载多张图片的场景,运行效果如下图所示: ![单张图片预加载](http://storage.360buyimg.com/mtd/home/single-img-load1483686270312.gif) ![多张图片预加载](http://storage.360buyimg.com/mtd/home/multi-img-load1483686388552.gif) \- eof -