InfiniteScroll

Simulate loading error

Activity record 1
Activity record 2
Activity record 3

Usage

import { InfiniteScroll } from "@devvy-ui/react";

<InfiniteScroll label="Activity feed" hasMore={hasMore} onLoadMore={loadMore}>{items}</InfiniteScroll>

API reference

Native HTML attributes, className, style and a forwarded ref are supported. Component-specific props:

Prop	Type	Default	Description
hasMore	boolean	required	Whether more records exist.
onLoadMore	() => void or Promise<void>	required	Application request.
loading / automatic	boolean	false	External busy state and optional observation.

Source ownership

Run npx @devvy-ui/cli init once in your React project, then add the source:

npx @devvy-ui/cli add infinite-scroll

Make the source yours.

Start from the canonical implementation used by the package and registry. Change the code, keep the MIT notice, and build the behavior your project needs.

InfiniteScroll.tsxREACT / TSX

import { forwardRef, useEffect, useRef, useState, type HTMLAttributes } from 'react';
export interface InfiniteScrollProps extends HTMLAttributes<HTMLDivElement> {
  label: string;
  hasMore: boolean;
  onLoadMore: () => Promise<void> | void;
  loading?: boolean;
  automatic?: boolean;
}
export const InfiniteScroll = forwardRef<HTMLDivElement, InfiniteScrollProps>(
  function InfiniteScroll(
    {
      label,
      hasMore,
      onLoadMore,
      loading = false,
      automatic = false,
      children,
      className,
      ...props
    },
    ref,
  ) {
    const [busy, setBusy] = useState(false),
      [error, setError] = useState(''),
      sentinel = useRef<HTMLDivElement>(null),
      pending = useRef(false),
      alive = useRef(true),
      load = useRef<() => void>(() => {});
    useEffect(() => {
      alive.current = true;
      return () => {
        alive.current = false;
      };
    }, []);
    const request = async () => {
      if (pending.current || loading || !hasMore) return;
      pending.current = true;
      setBusy(true);
      setError('');
      try {
        await onLoadMore();
      } catch {
        if (alive.current) setError('Could not load more. Try again.');
      } finally {
        pending.current = false;
        if (alive.current) setBusy(false);
      }
    };
    useEffect(() => {
      load.current = request;
    });
    useEffect(() => {
      if (!automatic || !hasMore || loading || typeof IntersectionObserver === 'undefined') return;
      const observer = new IntersectionObserver((entries) => {
        if (entries.some((e) => e.isIntersecting)) load.current();
      });
      if (sentinel.current) observer.observe(sentinel.current);
      return () => observer.disconnect();
    }, [automatic, hasMore, loading]);
    return (
      <div
        {...props}
        ref={ref}
        aria-label={label}
        aria-busy={busy || loading}
        className={['dvy-infinite-scroll', className].filter(Boolean).join(' ')}
      >
        {children}
        <div ref={sentinel} />
        <p role="status">{error || (!hasMore ? 'All items loaded.' : '')}</p>
        {hasMore && (
          <button
            type="button"
            className="dvy-button"
            disabled={busy || loading}
            onClick={() => load.current()}
          >
            {busy || loading ? 'Loading…' : error ? 'Retry loading' : 'Load more'}
          </button>
        )}
      </div>
    );
  },
);

Edit your own copy. Downloaded source uses your changes; the component preview above uses the shipped version. Run the source installer first to include shared helpers.

Interactive preview

Usage

API reference

Accessibility & behavior

Platform Behavior & Guidelines

Source ownership

Make the source yours.