# 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 目录的事例,包括加载单张图片、及加载多张图片的场景,运行效果如下图所示:


\- eof -