Communitygithub.com

YepAPI/skills

Cursor-basierte Paginierung, IntersectionObserver, virtualisierte Listen mit @tanstack/react-virtual und Wiederherstellung der Scrollposition.

Was ist skills?

Dieses Skill definiert Best Practices für die Implementierung von unendlichem Scrollen (Infinite Scroll) in React-Anwendungen. Es behandelt essenzielle Techniken wie cursor-basierte Paginierung, die Einbettung eines IntersectionObservers für automatisches Nachladen, und Virtualisierung großer Listen mittels @tanstack/react-virtual, um die DOM-Belastung zu minimieren. Entwickler lernen, wie sie Ladevorgänge mit Skeletten visualisieren, einen „Mehr laden“-Button als Fallback anbieten, die Scrollposition über `sessionStorage` oder Router-Status wiederherstellen und klare Zustände wie leere Listen oder das Ende der Daten darstellen. Das Skill unterstützt gängige React-Plattformen und -Tools wie TanStack Query und React Virtual, und zeigt anhand von Codebeispielen die Integration dieser Konzepte in eine produktionsreife Komponente. Es vermeidet gängige Fallstricke wie offset-basierte Paginierung, clientseitiges Filtern aller Daten, das Rendern tausender DOM-Knoten ohne Virtualisierung und fehlende End-of-List-Indikatoren. Die klaren Regeln und anti-patterns helfen, performante und benutzerfreundliche Listen mit unendlichem Scrollen zu realisieren.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/infinite-scroll

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Unendliches Scrollen

Regeln

  • Cursor-basierte Paginierung: Verwende die ID oder den Zeitstempel des letzten Elements als Cursor – nicht den Offset, der bei Einfügungen/Löschungen bricht.
  • IntersectionObserver: Befestige ihn an einem Wächter-Element am unteren Ende der Liste – löse das Abrufen aus, wenn es sichtbar wird.
  • Virtualisierung: @tanstack/react-virtual für Listen mit 1.000+ Elementen – rendert nur sichtbare Zeilen im DOM.
  • Lade-Skelett: Zeige Platzhalter-Elemente am unteren Ende während des Abrufens der nächsten Seite an – keinen Spinner.
  • „Mehr laden“-Button: Stelle diesen als Fallback für Benutzer bereit, die manuelle Steuerung bevorzugen oder langsame Verbindungen haben.
  • Wiederherstellung der Scrollposition: Speichere die Scrollposition vor der Navigation, stelle sie beim Zurückkehren wieder her – verwende sessionStorage oder den Router-Status.
  • Leerer Zustand: Zeige eine Nachricht an, wenn die Liste null Elemente enthält – keine leere Seite.
  • Ende der Liste: Zeige „Du hast das Ende erreicht“ an, wenn hasNextPage false ist – stoppe den Observer.

Muster

// Unendliches Scrollen mit React Query + IntersectionObserver
import { useInfiniteQuery } from "@tanstack/react-query";
import { useRef, useEffect } from "react";

function InfiniteList() {
  const sentinelRef = useRef<HTMLDivElement>(null);
  const { data, fetchNextPage, hasNextPage, isFetchingNextPage } = useInfiniteQuery({
    queryKey: ["items"],
    queryFn: ({ pageParam }) => fetchItems({ cursor: pageParam, limit: 20 }),
    getNextPageParam: (lastPage) => lastPage.nextCursor ?? undefined,
    initialPageParam: undefined as string | undefined,
  });

  useEffect(() => {
    const observer = new IntersectionObserver(
      (entries) => { if (entries[0].isIntersecting && hasNextPage) fetchNextPage(); },
      { rootMargin: "200px" } // Vorausladen, bevor der Benutzer den unteren Rand erreicht
    );
    if (sentinelRef.current) observer.observe(sentinelRef.current);
    return () => observer.disconnect();
  }, [hasNextPage, fetchNextPage]);

  const allItems = data?.pages.flatMap((page) => page.items) ?? [];

  return (
    <div>
      {allItems.map((item) => <ItemCard key={item.id} item={item} />)}
      {isFetchingNextPage && <LoadingSkeleton count={3} />}
      {!hasNextPage && allItems.length > 0 && <p>Du hast das Ende erreicht</p>}
      {allItems.length === 0 && !isFetchingNextPage && <EmptyState />}
      <div ref={sentinelRef} />
    </div>
  );
}

// Virtualisierte Liste für 10k+ Elemente
import { useVirtualizer } from "@tanstack/react-virtual";

function VirtualList({ items }: { items: Item[] }) {
  const parentRef = useRef<HTMLDivElement>(null);
  const virtualizer = useVirtualizer({
    count: items.length,
    getScrollElement: () => parentRef.current,
    estimateSize: () => 64, // geschätzte Zeilenhöhe in px
    overscan: 5,
  });

  return (
    <div ref={parentRef} style={{ height: "600px", overflow: "auto" }}>
      <div style={{ height: `${virtualizer.getTotalSize()}px`, position: "relative" }}>
        {virtualizer.getVirtualItems().map((virtualRow) => (
          <div key={virtualRow.key} style={{
            position: "absolute", top: 0, left: 0, width: "100%",
            transform: `translateY(${virtualRow.start}px)`,
          }}>
            <ItemCard item={items[virtualRow.index]} />
          </div>
        ))}
      </div>
    </div>
  );
}

Vermeiden

  • Offset-basierte Paginierung – Einfügungen/Löschungen verschieben alle Offsets, was zu doppelten oder fehlenden Elementen führt.
  • Laden aller Elemente und dann clientseitiges Filtern – rufe nur die aktuelle Seite vom Server ab.
  • Rendern von 10k+ DOM-Knoten – verwende @tanstack/react-virtual, um nur sichtbare Zeilen zu rendern.
  • IntersectionObserver ohne rootMargin – füge einen Rand von 100–200px hinzu, um vorzuladen, bevor der Benutzer den unteren Rand erreicht.
  • Fehlender End-of-List-Indikator – Benutzer müssen wissen, dass es nichts mehr zu laden gibt.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Tenant isolation (row-level vs schema), subdomain routing, per-tenant config, and data partitioning.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

Verwandte Skills