image-loader-spinner
Advanced tools
Use a spinner until your images are completely loaded in the DOM
npm i image-loader-spinner
import ImageLoader from 'image-loader-spinner';
// first argument is an default image src error (default is null)
// second argument is the default size of loading container in pixel (default is 100)
ImageLoader('assets/images/errorLoad.png', 150);
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<title>My test page</title>
</head>
<body>
<style>
.spinner_container {
display: flex;
align-items: center;
background-color: rgba(0, 0, 0, 0.05);
}
.spinner {
border: 3px solid #333;
border-bottom-color: transparent;
border-radius: 50%;
display: inline-block;
box-sizing: border-box;
animation: rotation 1s linear infinite;
margin: auto
}
@keyframes rotation {
0% {
transform: rotate(0deg);
}
100% {
transform: rotate(360deg);
}
}
</style>
<img src="assets/images/image.png" spinner="true" fadein="true"/> <!-- Show spinner container with defaultSize and fadeIn animation -->
<img src="assets/images/image.png" spinner="true" size="150px" /> <!-- Show spinner container with widthSize 150px, heightSize 150px -->
<div class="insideDiv">
<img src="assets/images/image.png" spinner="true" wsize="50%" hsize="200px" /> <!-- Show spinner container with widthSize 50px, heightSize 200px -->
</div>
</body>
</html>
Add the attribute spinner to true for set the loading spinner instead an empty image.
The attribute size is the size of your spinner_container (by default is set to 100 or your default value configuration).
The attribute wsize is the width size of your spinner_container
The attribute hsize is the height size of your spinner_container
The attribute fadein will display your image with fadeIn animation to your opacity value (20fps)
Values can be set to pixels, percentages, and viewports.
The spinner will be half the size of your container.
Your spinner will be display as :
<div class="spinner_container">
<div class="spinner"></div>
</div>
import ImageLoader from 'image-loader-spinner';
ImageLoader();
const image = new Image();
image.setAttribute("spinner", "true");
image.setAttribute("hsize", "200")
image.setAttribute("wsize", "100%")
setTimeout(() => {
image.src = "https://i.imgur.com/rsjPao4.gif";
}, 5000)
document.body.appendChild(image);
import ImageLoader from 'image-loader-spinner';
ImageLoader();
setTimeout(() => {
const image = document.getElementById("myImage");
image.setAttribute("spinner", "true");
// image.setAttribute("size", "100"); // redefine size of the loader container
image.src = "https://i.imgur.com/rsjPao4.gif";
}, 5000);
FAQs
Use a spinner until your images are completely loaded in the DOM
We found that image-loader-spinner demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
The Socket Threat Research Team uncovered a coordinated campaign that floods the Chrome Web Store with 131 rebranded clones of a WhatsApp Web automation extension to spam Brazilian users.
Security News
ENISA’s 2025 Threat Landscape report highlights how AI is reshaping cyber attacks, driving phishing, model poisoning, and software supply chain risks.
Security News
Evan You announces Vite+, a commercial, Rust-powered toolchain built on the Vite ecosystem to unify JavaScript development and fund open source.