mintuz/react-intersect

A react component which observes when an element becomes in or out of the viewport you provided. Useful for lazy loading and sending tracking events to analytics on scroll.

React Intersect

A react component which observes when an element becomes in or out of the viewport you provided. Useful for lazy loading and sending tracking events to analytics on scroll.

Internally this makes use of another library I created called Horizon and tracking of elements is done via the Intersection Observer API allowing for performant tracking on the web as it's done off the main thread reducing jank whilst scrolling.

This component makes use of the render props and state reducer patterns

• State reducer
• render props

Install

yarn add @mintuz/react-intersect --save

Usage

Config

Key	Value	Description	Default
onEntry	(entry) => {}	Callback which is called when the element is in view	N/A
onExit	(entry) => {}	Callback which is called when the element is out of view	N/A
triggerOnce	true	Will trigger onEntry callback once, useful for lazyLoading	false
render	(inView) => {return <div></div>}	Render prop that returns a single boolean of if in view or not, use to conditionally load an element when in view	N/A
intersectionObserverConfig	{ root: null, rootMargin: '35%', threshold: 0 }	Options passed to IntersectionObserver API	{ root: null rootMargin: '35%', threshold: 0 }
stateReducer	(prevState, changes) => {return {inView:false}}	Allow for external manipulation of the internal state of react-intersect	N/A

Hook API

const ReactIntersectHook = () => {
  const [inView, ref] = useIntersect({
    triggerOnce: false
  });
  return (
    <div ref={ref}>
      {inView ? "I am in view " : "I am not view"}
    </div>
  );
};

Demo

https://codesandbox.io/s/vvm485k697

react-intersect's Issues

onEntry does not work with useIntersect

It's not called at all.