blazed
v0.0.3
Published
A little lazy loading library for size-specific CSS background images.
Downloads
7
Maintainers
Readme
Blazed
Specify image URLs and breakpoints, just like srcset. Blazed will find the size that fits the current viewport and smoothly load the image.
API
blazed([selector][, attribute])
selector
– either a DOM selector compatible with document.querySelectorAll
, or a single DOM node. If you pass an attribute as the selector
param, attribute
will map to your selector
attribute instead. default: [data-src]
attribute
– a data attribute that contains your asset urls and breakpoints. default: data-src
attribute="<imageDefault>[, <imageURL> <imageBreakpoint>] ..."
imageDefault
– this URL is required, and represents the smallest image in the stack. All other images and breakpoints are optional, and represent min-width
based media queries.
Example
<!-- default -->
<div data-src="image-small.jpg, image-medium.jpg 800, image-large.jpg 1100"></div>
<!-- custom selector -->
<div data-bg-src="image-small.jpg"></div>
<!-- custom selector and attribute -->
<div class="js-background" data-bg-src="image-small.jpg"></div>
<!-- passed element, custom selector -->
<div class="js-background" data-bg-src="image-small.jpg, image-medium.jpg 800, image-large.jpg 1100"></div>
// relative to the above examples
blazed()
blazed('[data-bg-src]')
blazed('.js-background', 'data-bg-src')
let imageToLoad = document.querySelector('.js-background')
blazed(imageToLoad, 'data-bg-src')