@kaliber/use-is-intersecting

useIsIntersecting

Check whether an element intersects with its root element

Motivation

Reports wether an element is intersecting a root element using the IntersectionObserver. This is more performant and easier to use than listening to scroll and resize events and even responds to element resizing, which might not trigger these events.

Polyfill

The IntersectionObserver is supported by most current browsers. If you need wider support, there is a polyfill available through polyfill.io.

Using @kaliberjs/build, you can add the following argument to the polyfill() call.

{polyfill(['default', 'IntersectionObserver'])}

Without, you can manually add the following script to your page (or include it in your build):

https://polyfill.io/v3/polyfill.min.js?features=IntersectionObserver

Installation

yarn add @kaliber/use-is-intersecting

Usage

export default function App() {
  const [root, setRoot] = React.useState(null)
  const { ref: isIntersectingRef, isIntersecting } = useIsIntersecting({ root, rootMargin: '-10%' })
  const { ref: wasIntersectingRef, wasIntersecting } = useWasIntersecting({ root, rootMargin: '-10%' })

  return (
    <div>
      <div className={styles.scrollWrapper}>
        <div ref={setRoot} className={styles.scroll}>
          <div ref={isIntersectingRef}>
            {isIntersecting 
              ? 'Is in intersection root element'  
              : 'Is not in intersection root element'}
          </div>

          <div ref={wasIntersectingRef} >
            {wasIntersecting 
              ? 'Has been in intersection root element' 
              : 'Has not yet been in intersection root element'}
          </div>
        </div>
      </div>
    </div>
  )
}

The useIsIntersecting hook also returns wether an element has been intersecting in the past (wasIntersecting). The main difference with the dedicated useWasIntersecting hook is that the IntersectionObserver doesn't get cleaned up, since the hook still has to track wether the element is currently intersecting. This can be useful if you want to pause an expensive operation, but also want the element to have a reveal animation.

export default function App() {
  const [root, setRoot] = React.useState(null)
  const { ref: elementRef, isIntersecting, wasIntersecting } = useIsIntersecting({ root })

  return (
    <div>
      <div className={styles.scrollWrapper}>
        <div ref={setRoot} className={styles.scroll}>
          <div ref={elementRef} className={cx(wasIntersecting && styles.isRevealed)}>
            {isIntersecting 
              ? 'Is in intersection root element'  
              : 'Is not in intersection root element'}
          </div>
        </div>
      </div>
    </div>
  )
}

Disclaimer

This library is intended for internal use, we provide no support, use at your own risk. It does not import React, but expects it to be provided, which @kaliber/build can handle for you.

This library is not transpiled.