# @types/imagesloaded

> TypeScript definitions for imagesloaded

Latest version **4.1.7** (published 2025-05-16) · MIT license · 0 weekly downloads

## Install

```sh
npm install @types/imagesloaded
pnpm add @types/imagesloaded
yarn add @types/imagesloaded
bun add @types/imagesloaded
```

## Health

**Score 55/100 (C)** — status: stable.

Positive: has types; no vulnerabilities; high maintenance score; popular repo; extremely popular.

Warnings: low downloads; no esm support.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 4.1.7 |
| Published | 2025-05-16 |
| First published | 2016-05-17 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 6.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 51450 |
| Maintainers | types |

## Links

- npm: https://www.npmjs.com/package/@types/imagesloaded
- Repository: https://github.com/DefinitelyTyped/DefinitelyTyped
- Homepage: https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/imagesloaded
- npm.io page: https://npm.io/package/@types/imagesloaded

## Dependencies (1)

- [@types/jquery](https://npm.io/package/@types/jquery.md) *

## Recent versions

- 4.1.7 (latest) — 2025-05-16
- 4.1.6 (ts4.5) — 2023-11-21
- 4.1.2 (ts2.3) — 2019-11-01
- 4.1.0 (ts2.0) — 2017-03-10
- 4.1.5 — 2023-11-07
- 4.1.4 — 2023-10-18
- 4.1.3 — 2023-09-26
- 4.1.1 — 2017-06-15
- 3.1.29 — 2016-12-23
- 3.1.28 — 2016-09-19
- 3.1.27 — 2016-07-14
- 3.1.26-alpha — 2016-07-08
- 3.1.25-alpha — 2016-07-04
- 3.1.24-alpha — 2016-07-02
- 3.1.23-alpha — 2016-07-01
- … 5 more at https://npm.io/package/@types/imagesloaded/versions

## README

# Installation
> `npm install --save @types/imagesloaded`

# Summary
This package contains type definitions for imagesloaded (https://github.com/desandro/imagesloaded).

# Details
Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/imagesloaded.
## [index.d.ts](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/imagesloaded/index.d.ts)
````ts
/// <reference types="jquery" />

declare namespace ImagesLoaded {
    type ElementSelector = Element | NodeList | Element[] | string;

    /** interface for an image currently loading or completed */
    interface LoadingImage {
        img: HTMLImageElement;
        isLoaded: boolean;
    }

    interface ImagesLoadedCallback {
        (instance?: ImagesLoaded): void;
    }

    interface ImagesLoadedListener {
        (instance: ImagesLoaded, image?: LoadingImage): void;
    }

    interface ImagesLoaded {
        new(elem: ElementSelector, callback: ImagesLoadedCallback): ImagesLoaded;

        images: LoadingImage[];

        // event listeners
        on(event: string, listener: ImagesLoadedListener): void;
        off(event: string, listener: ImagesLoadedListener): void;
        once(event: string, listener: ImagesLoadedListener): void;
    }

    interface ImagesLoadedOptions {
        background: true | string;
    }

    interface ImagesLoadedConstructor {
        /**
         * Creates a new ImagesLoaded object with the provided callback
         * @param elem Element, NodeList, Element array, or selector string for images to watch
         * @param options object that can tell imagesloaded to watch background images as well
         * @param callback function triggered after all images have been loaded
         */
        (elem: ElementSelector, options: ImagesLoadedOptions, callback?: ImagesLoadedCallback): ImagesLoaded;
        (elem: ElementSelector, callback?: ImagesLoadedCallback): ImagesLoaded;
    }
}

declare var imagesLoaded: ImagesLoaded.ImagesLoadedConstructor;

declare module "imagesloaded" {
    export = imagesLoaded;
}

interface JQuery {
    imagesLoaded(callback?: ImagesLoaded.ImagesLoadedCallback): JQueryDeferred<ImagesLoaded.ImagesLoaded>;
    imagesLoaded(
        options: ImagesLoaded.ImagesLoadedOptions,
        callback?: ImagesLoaded.ImagesLoadedCallback,
    ): JQueryDeferred<ImagesLoaded.ImagesLoaded>;
}

````

### Additional Details
 * Last updated: Fri, 16 May 2025 23:33:24 GMT
 * Dependencies: [@types/jquery](https://npmjs.com/package/@types/jquery)

# Credits
These definitions were written by [Cameron Little](https://github.com/apexskier).

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