# imgloader

> Simple, lightweight module to load images asynchronously using javascript in browsers.

Latest version **1.0.0** (published 2017-06-10) · MIT license · 0 weekly downloads

## Install

```sh
npm install imgloader
pnpm add imgloader
yarn add imgloader
bun add imgloader
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.0 |
| Published | 2017-06-10 |
| First published | 2017-06-10 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Shrey Jain |
| Maintainers | shreyjain1994 |

## Links

- npm: https://www.npmjs.com/package/imgloader
- Repository: https://github.com/shreyjain1994/imgloader
- Homepage: https://github.com/shreyjain1994/imgloader#readme
- Issues: https://github.com/shreyjain1994/imgloader/issues
- npm.io page: https://npm.io/package/imgloader

## Recent versions

- 1.0.0 (latest) — 2017-06-10

## README

# IMG Loader

Simple, lightweight module to load images asynchronously using javascript in browsers.

The main use-case for which the module was written was to load image assets for an HTML game in the
background, and to be informed once the loading was complete so the game could be started.

## Installation

    npm install imgloader
    
This module is written to be used and bundled using Webpack, or another such bundling tool. There is
currently no standalone js script that can be loaded directly.

## Usage

```javascript
var IMGLoader = require('imgloader');

//a description of the images to load
var manifest = [
    {
        id:'foo',
        src:'example.com/image1'
    },
    {
        id:'bar',
        src:'example.com/image2'
    }
];

//images are not loaded at this point...this simply creates a queue of images
var loader = new IMGLoader(manifest);

loader.load(function(images){
    var fooImage = images.foo;
    var barImage = images.bar;
    
    //...do whatever you need to do with fooImage and barImage
});

loader.loadSequentially(function(images){
    //...do whatever with loaded images
});
```

### Manifest

The manifest is an array of objects describing the images you want to load, and must be provided
when creating a new IMGLoader. The description of each image requires 2 properties:

1. id - a unique string used to identify the image. This will be used in the object returned
to you once the images are all loaded.
2. src - The URL to the image.

### Load Function

This function actually starts loading the images. It requires a function that is called
once the all the images are loaded. The callback function is provided an object mapping from
the image IDs to the loaded HTMLImageElement.

### LoadSequentially Function

This function is nearly identical to the load function, except it will load the images
in the order specified by the manifest.

## License

MIT.

---
_Source: https://npm.io/package/imgloader · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._