Loads images, background images, scripts, styles, iframes, videos and audios asynchronously (just 241 bytes).
Switch branches/tags
develop gh-pages greenkeeper/coveralls-3.0.0 greenkeeper/coveralls-3.0.1 greenkeeper/gulp-4.0.0 greenkeeper/gulp-header-1.8.9 greenkeeper/gulp-header-2.0.1 greenkeeper/gulp-header-2.0.2 greenkeeper/gulp-header-2.0.3 greenkeeper/gulp-header-2.0.5 greenkeeper/gulp-header-2.0.7 greenkeeper/gulp-rename-1.2.3 greenkeeper/gulp-rename-1.3.0 greenkeeper/gulp-rename-1.4.0 greenkeeper/gulp-replace-0.6.0 greenkeeper/gulp-replace-0.6.1 greenkeeper/gulp-replace-1.0.0 greenkeeper/gulp-uglify-2.1.0 greenkeeper/gulp-uglify-2.1.1 greenkeeper/gulp-uglify-2.1.2 greenkeeper/gulp-uglify-3.0.0 greenkeeper/gulp-uglify-3.0.1 greenkeeper/jsdom-9.11.0 greenkeeper/jsdom-9.12.0 greenkeeper/jsdom-10.0.0 greenkeeper/jsdom-10.1.0 greenkeeper/jsdom-11.0.0 greenkeeper/jsdom-11.1.0 greenkeeper/jsdom-11.2.0 greenkeeper/jsdom-11.3.0 greenkeeper/jsdom-11.4.0 greenkeeper/jsdom-11.5.0 greenkeeper/jsdom-11.5.1 greenkeeper/jsdom-11.6.0 greenkeeper/jsdom-11.6.1 greenkeeper/jsdom-11.6.2 greenkeeper/jsdom-11.7.0 greenkeeper/jsdom-11.8.0 greenkeeper/jsdom-11.9.0 greenkeeper/jsdom-11.10.0 greenkeeper/jsdom-11.11.0 greenkeeper/jsdom-11.12.0 greenkeeper/jsdom-12.0.0 greenkeeper/jsdom-12.1.0 greenkeeper/jsdom-12.2.0 greenkeeper/jsdom-13.0.0 greenkeeper/mocha-4.0.0 greenkeeper/mocha-4.0.1 greenkeeper/mocha-4.1.0 greenkeeper/mocha-5.0.0 greenkeeper/mocha-5.0.1 greenkeeper/mocha-5.0.2 greenkeeper/mocha-5.0.3 greenkeeper/mocha-5.0.4 greenkeeper/mocha-5.0.5 greenkeeper/mocha-5.1.0 greenkeeper/mocha-5.1.1 greenkeeper/mocha-5.2.0 greenkeeper/update-to-node-10 master
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.



NPM version License Build status Coverage Status Dependency status devDependency status downloads

Loads images, background images, scripts, styles, iframes, videos and audios asynchronously (just 241 bytes).



Loads images, background images, scripts, styles, iframes, videos and audios asynchronously.

  • nodeList {NodeList} [optional] - A NodeList of elements. By default, it is the result of querySelectorAll('[data-aload]').


$ npm install aload

$ bower install aload

Note: I recommend to use aload inline in your HTML.

As standalone just include aload function (just 241 bytes) inline into your HTML file:

  function aload(t){"use strict";var e="data-aload";return t=t||window.document.querySelectorAll("["+e+"]"),void 0===t.length&&(t=[t]),[].forEach.call(t,function(t){t["LINK"!==t.tagName?"src":"href"]=t.getAttribute(e),t.removeAttribute(e)}),t}


  1. You should use data-aload attributes instead of src or href in your HTML tags (an image for example):
<img data-aload="http://foobar.com/foo.png" width="400" height="300">
  • data-aload - URL of the source.
  1. Now, you can start to load your images asynchronously!
// Onload
window.onload = function () {

You can load everything asynchronously.

  • images
  • background images
  • scripts
  • styles
  • iframes
  • videos
  • audios


<img data-aload="http://foobar.com/foo.png" width="400" height="300">


  1. You must add the following CSS snippet.
[data-aload] { background-image: none !important; }
  1. Your own CSS.
.foo {
  background: url('http://foobar.com/foobar.png');
  1. In your HTML.
<div data-aload class="foo"></div>


<script data-aload="http://foobar.com/foo.js"></script>

LINK (styles)

<link data-aload="http://foobar.com/foo.css" rel="stylesheet">


<iframe data-aload="http://foobar.com" src="javascript:false"></iframe>


<video data-aload="http://foobar.com/bar.mp4" controls></video>


<audio data-aload="http://foobar.com/foo.mp3" controls></audio>

Progressive Enhancement

If you are a front-end developer you must know about Progressive enhancement. Progressive enhancement focuses on the content and it must be showed without JavaScript.

For example, to show images when JavaScript is not enabled you should include the images inside <noscript> tag.

<img data-aload="http://foobar.com/foo.png"
    <img src="http://foobar.com/foo.png" width="400" height="300">


  1. Install Git and NodeJS.

  2. Install gulp:

     $ npm install gulp -g
  3. Open your terminal and clone aload by running:

     $ git clone git@github.com:pazguille/aload.git
  4. Go to aload's folder:

     $ cd aload
  5. Move to develop branch:

     $ git checkout develop
  6. Install its dependencies:

     $ npm install
  7. Code, code code!

  8. Send pull requests.

NPM tasks

  • npm run dist: Creates a distribution version of aload. You should find two files: ./dist/aload.js and ./dist/aload.min.js.
  • npm test: Runs mocha tests.

With ❤️ by


MIT license. Copyright © 2016.