use-in-viewport-react

Live Demo - Click Here

A lightweight and performant React hook to check if an element is in the viewport using the Intersection Observer API. This hook allows you to easily track an element’s visibility and trigger UI updates, animations, lazy loading, or other effects when an element enters or leaves the viewport.

🚀 Features

✅ Tiny & Fast – Uses the native IntersectionObserver API for efficient performance.
✅ Customizable – Supports root, rootMargin, and threshold options for precise control.
✅ Simple API – Just pass a ref, and get a boolean indicating visibility.
✅ No Dependencies – Pure React, works with React 16.8+ (including React 19).
✅ SSR Compatible – Works well with frameworks like Next.js.

Installation

To install the package, run:

npm install use-in-viewport-react

Usage

Example Usage in a Functional Component

import { useRef } from 'react';
import { useInViewportReact } from 'use-in-viewport-react';

function App() {
  const ref = useRef<HTMLDivElement>(null);
  const isInViewport = useInViewportReact(ref, {
    threshold: 1,
  });

  return (
    <div>
      <h1>Testing useInViewportReact Hook</h1>
      <div style={{ height: '100vh', background: '#f0f0f0' }}>
        <p>
          Scroll down to see the change in color when the box comes into view.
        </p>
      </div>

      <div
        ref={ref}
        style={{
          height: '200px',
          background: isInViewport ? 'green' : 'red',
          transition: 'background-color 0.3s ease',
        }}
      >
        This element is {isInViewport ? 'in' : 'out of'} the viewport.
      </div>

      <div style={{ height: '100vh', background: '#f0f0f0' }}>
        <p>Scroll further to test the visibility change.</p>
      </div>
    </div>
  );
}

export default App;

📌 Use Cases

🔹 Lazy Load Images & Components – Load content only when it becomes visible to optimize performance.
🔹 Infinite Scrolling – Detect when users reach the bottom of a list and fetch more content dynamically.
🔹 Trigger Animations – Animate elements when they appear in the viewport for a better UX.
🔹 Sticky Elements – Change styles or behavior when an element enters/leaves the viewport.
🔹 Ad Tracking & Analytics – Track when specific content is visible to users.

⚙️ Options

Option	Type	Default	Description
root	Element | null	null	The element used as the viewport. Defaults to null (browser viewport).
rootMargin	string	"0"	Margin around the root element (e.g., "10px").
threshold	number | number[]	0.1	Visibility percentage that triggers the observer.

🛠️ Compatibility

✅ React 16.8+ (Hooks API)
✅ React 17, 18, and 19
✅ ES5 & ES6 compatible
✅ Works with Next.js, Gatsby, Vite, and Create React App

🌟 Why use use-in-viewport-react?

There are several similar hooks available, but use-in-viewport-react is optimized for performance, simplicity, and flexibility. It helps you build smooth scrolling experiences, lazy load content, and create engaging animations with minimal effort.