Skip to content

feat: add intersection observer root option #217

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 3 commits into
base: master
Choose a base branch
from
Draft

feat: add intersection observer root option #217

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
d443ed9
feat: add intersection observer root option
lbendavid-cloudinary Jul 25, 2023
e9c232e
feat: add intersection observer root option
lbendavid-cloudinary Jul 25, 2023
829bee3
feat: add intersection observer root option
lbendavid-cloudinary Jul 25, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 9 additions & 6 deletions packages/html/src/plugins/lazyload.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,14 @@ import {CloudinaryImage} from "@cloudinary/url-gen/assets/CloudinaryImage";
import {Plugin, HtmlPluginState, PluginResponse} from '../types'
import {isBrowser} from "../utils/isBrowser";

type IntersectionObserverInitRoot = IntersectionObserverInit['root'];

/**
* @namespace
* @description Loads an image once it is in a certain margin in the viewport. This includes vertical and horizontal scrolling.
* @param rootMargin {string} The root element's bounding box before the intersection test is performed. Default: 0px.
* @param threshold {number} The percentage of the image's visibility at which point the image should load. Default: 0.1 (10%).
* @param root {Element} The element that is used as the viewport for checking visibility of the target. Must be the ancestor of the target. Defaults to the browser viewport if not specified or if null.
* @return {Plugin}
* @example
* <caption>
Expand All @@ -17,8 +20,8 @@ import {isBrowser} from "../utils/isBrowser";
* <AdvancedImage style={{width: "400px", height: "400px"}} cldImg={img} plugins={[lazyload({rootMargin: '0px',
* threshold: 0.25})]} />
*/
export function lazyload({rootMargin='0px', threshold=0.1}:{rootMargin?: string, threshold?: number}={}): Plugin{
return lazyloadPlugin.bind(null, rootMargin, threshold);
export function lazyload({rootMargin='0px', threshold=0.1, root}:{rootMargin?: string, threshold?: number, root?: IntersectionObserverInitRoot}={}): Plugin{
return lazyloadPlugin.bind(null, rootMargin, threshold, root);
}
/**
* @description lazyload plugin
Expand All @@ -29,13 +32,13 @@ export function lazyload({rootMargin='0px', threshold=0.1}:{rootMargin?: string,
* @param cloudinaryImage {CloudinaryImage}
* @param htmlPluginState {HtmlPluginState} Holds cleanup callbacks and event subscriptions.
*/
function lazyloadPlugin(rootMargin='0px', threshold=0.1 , element: HTMLImageElement | HTMLVideoElement, cloudinaryImage: CloudinaryImage, htmlPluginState: HtmlPluginState): Promise<PluginResponse> | boolean {
function lazyloadPlugin(rootMargin='0px', threshold=0.1 , root: IntersectionObserverInitRoot, element: HTMLImageElement | HTMLVideoElement, cloudinaryImage: CloudinaryImage, htmlPluginState: HtmlPluginState): Promise<PluginResponse> | boolean {
// if SSR skip plugin
if(!isBrowser()) return false;

return new Promise((resolve) => {
const onIntersect = () => (resolve({lazyload: true}));
const unobserve = detectIntersection(element, onIntersect, rootMargin, threshold);
const unobserve = detectIntersection(element, onIntersect, rootMargin, threshold, root);

htmlPluginState.cleanupCallbacks.push(()=>{
unobserve();
Expand All @@ -61,7 +64,7 @@ function isIntersectionObserverSupported() {
* @param rootMargin {string} The root element's bounding box before the intersection test is performed. Default: 0px.
* @param threshold {number} The percentage of the image's visibility at which point the image should load. Default: 0.1 (10%).
*/
function detectIntersection(el: HTMLImageElement | HTMLVideoElement, onIntersect: Function, rootMargin: string, threshold: number | number[]) {
function detectIntersection(el: HTMLImageElement | HTMLVideoElement, onIntersect: Function, rootMargin: string, threshold: number | number[], root: IntersectionObserverInitRoot) {
try {
if (!isIntersectionObserverSupported()) {
// Return if there's no need or possibility to detect intersection
Expand All @@ -77,7 +80,7 @@ function detectIntersection(el: HTMLImageElement | HTMLVideoElement, onIntersect
onIntersect();
}
});
}, {rootMargin: rootMargin, threshold: threshold});
}, {rootMargin, threshold, root });
observer.observe(el);

return ()=>{el && observer.observe(el)};
Expand Down