node package manager
Stop wasting time. Easily manage code sharing in your team. Create a free org »


React Asset Loader

A simple react component for loading assets. It allows you to load from a single asset to multiple assets without affecting the pageload speed. You can also add custom classes, attributes and callback functions.


We all get scared of heavy websites, there are tons and tons of articles telling us why we shouldn't build websites using heavy assets like videos or gifs. But sometimes, you just need to, sometimes you just need to build a cool interactive experience with videos, or so something cool with gifs, or a long page with lots of high quality images, etc. This component is precisely for that.

How it works.

This component allows you to load all the assets you want without affecting the pageload speed, this is because it will load the page and then it will start loading all the assets, it adds a <div className="loading"></div> wrapper while it's loading the asset so you can have a nice custom loader, when the assets are loaded it will replace the loading wrapper with the actual assets.


npm install react-asset-loader --save-dev

Or just grab the component LoadAsset.js directly.


Load a single asset.

<LoadAssets assets={[{"uri":"/static/images/asset.jpg"}]} />

Load multiple assets.

When you need to load more than one asset for one experience. It will be loadad after all the assets passed are loaded.

<LoadAssets assets={[{"uri":"/static/images/video1.mp4"}, {"uri":"/static/images/video2.mp4"}]} />
// or also 
var videos = [
<LoadAssets assets={videos} />

Adding classes.

You can add classes to each asset you pass to the component.

<LoadAssets assets={[{"uri":"/static/images/asset.jpg", "className":"class1 class2"}]} />

Adding attributes.

You can also add attributes to each asset you pass to the component.

<LoadAssets assets={[{"uri":"/static/images/video.mp4", "attributes":[{"autoPlay":"true"}, {"loop":"true"}]}]} />
// or also 
var video = [{
  "attributes": [
<LoadAssets assets={video} />

Custom onLoad callback.

You can have a custom callback for when your assets are loaded.

<LoadAssets onLoad={this.onCoolVideoLoaded} assets={[{"uri":"/static/images/video.mp4"}]} />


You'll need a webserver in order to run the examples (CORS). The quickest way to do this is just run this on the project folder:

python -m SimpleHTTPServer ## Feedback and contributions Are more than welcome. 👊


MIT Copyright (c) Juan Cabrera