captaincodeman / lazy-img

Lazy loading img

Demo and API docs

<lazy-image>

lazy-img is a lazy loading img element that is shadow-dom friendly and uses IntersectionObserver to detect when images are within the viewport and need to be loaded.

The default behavior is to use the browser viewport but more specific control can be provided by setting the observe property to a parent selector (either an element id, class or tag name):

<div id="myscroller">
        <lazy-img src="image1.jpg" observe="#myscroller"></lazy-img>
        <lazy-img src="image2.jpg" observe="#myscroller"></lazy-img>
        ...
        <lazy-img src="image99.jpg" observe="#myscroller"></lazy-img>
<div>

margin and threshold allow control over exactly when the loading is triggered as the element comes into view. margin can reduce or extend the detection area of the container and threshold can determine what proportion of the image needs to be within the area.

Demo is based on this example of intersection-observer

If used on a browser without support for IntersectionObserver a polyfill will be loaded automatically from the polyfill.io service.

Configure this with the following code in index.html:

<script>
  // Define polyfills for features that our app depends on:
  window.PolyPoly = {
    features: []
  };
  ('IntersectionObserver' in window) || window.PolyPoly.features.push('IntersectionObserver');
</script>

lazy-img's Issues

Set IntersectionObserver options

Provide a way to set options for IntersectionObserver

e.g. root element, thresholds etc...

Can it update to support polymer 3.0 ?

I like the lazy img dom. However, I cannot upgrade the dom via polymer polymer-modulizer. Can this dom upgrade to modulizer ?.?

Only load polyfill when necessary

Don't add an extra 20Kb to the page if the browser supports IntersectionObserver natively.