eduardweb.
shadcn/uiAvansat#nextjs#typescript#shadcn#react-table

Shadcn/ui DataTable pe bune: server-side pagination, sort și filtre în Next.js

De Liliana Ghiță, 24 oct. 2026 · 24 vizualizări · 2 like-uri

Postat 24 oct. 2026
typescript
import { useReactTable, getCoreRowModel, type PaginationState, type SortingState } from "@tanstack/react-table";
import { useRouter, usePathname, useSearchParams } from "next/navigation";

interface DataTableProps<TData> {
  data: TData[];
  pageCount: number;
  columns: any[];
}

export function ServerDataTable<TData>({ data, pageCount, columns }: DataTableProps<TData>) {
  const router = useRouter();
  const pathname = usePathname();
  const searchParams = useSearchParams();

  const page = Number(searchParams.get("page")) || 1;
  const perPage = Number(searchParams.get("perPage")) || 20;

  const pagination: PaginationState = { pageIndex: page - 1, pageSize: perPage };

  const table = useReactTable({
    data,
    columns,
    pageCount,
    state: { pagination },
    manualPagination: true,
    manualSorting: true,
    manualFiltering: true,
    getCoreRowModel: getCoreRowModel(),
    onPaginationChange: (updater) => {
      const next = typeof updater === "function" ? updater(pagination) : updater;
      const params = new URLSearchParams(searchParams.toString());
      params.set("page", String(next.pageIndex + 1));
      params.set("perPage", String(next.pageSize));
      router.push(`${pathname}?${params.toString()}`);
    },
  });

  // Returnează componentele Table, TableHeader, TableBody din shadcn/ui
  return null;
}

Toate tutorialele de shadcn/ui îți arată cum randezi un DataTable cu date statice pasate direct într-un array. Arată frumos în demo, dar la un client cu vreo 140.000 de log-uri de plăți am văzut tab-ul de Chrome cum înghițea 600MB de RAM înainte să crape cu out of memory. Pe scurt: filtrarea și sortarea pe client funcționează doar pentru tabele de jucărie.

Când treci datele pe server în Next.js App Router, TanStack Table v8 își schimbă complet rolul. Nu mai ține datele în memorie, ci devine doar un traducător între starea din UI și query params din URL.

Singura sursă de adevăr: URL-ul

Dacă ții pageIndex, sorting sau filtrele în useState local, ai pierdut deja. Nu poți da share la link, butonul de back din browser nu face ce trebuie, iar un refresh resetează tot tabelul.

Soluția pe care o folosesc în producție leagă direct starea tabelului de searchParams. Server Component-ul citește parametrii din URL, interoghează baza de date (cu LIMIT, OFFSET și ORDER BY), iar Client Component-ul doar afișează ce a primit și împinge schimbările înapoi în URL via useRouter sau nuqs.

De la un payload inițial de 4.2MB de JSON pe client, am coborât la sub 35KB per pagină de 20 de rânduri. Timpul până la primul byte randat a scăzut de la 1.8 secunde la 120ms.

Configurația manuală a stării în TanStack

Secretul la TanStack Table v8 când lucrezi server-side stă în trei flag-uri pe care multă lume le ratează: manualPagination: true, manualSorting: true și manualFiltering: true. Dacă uiți de ele, biblioteca va încerca în continuare să filtreze cele 20 de elemente deja paginate primite de la server, crezând că acela e întregul set de date.

Un mic avertisment la sortare: maparea dintre id-ul coloanei din frontend și coloana reală din baza de date (Postgres/Prisma/Drizzle) trebuie validată strict. Nu trimite niciodată string-ul brut direct în clauza orderBy, altfel riști SQL injection sau runtime errors când cineva alterează URL-ul manual cu un query param inexistent.

Trade-off-uri de care te lovești

Server-side data tables nu sunt un glonț de argint. Ai câteva dezavantaje clare față de varianta pe client:

  1. Debounce obligatoriu la filtre: Pe client cauți la fiecare tastă fără probleme. Pe server, dacă nu pui un debounce de cel puțin 300ms pe input-ul de text, îți îngropi serverul de baze de date în query-uri inutile la fiecare literă tastată de user.
  2. Flicker și skeleton states: Fiecare sortare înseamnă un round-trip de rețea. Trebuie să gestionezi stările de useTransition ca să nu pară interfața blocată în timp ce Next.js face Server Action-ul sau refetch-ul.

Pentru un CRUD intern cu 200 de useri, tot procesul ăsta e overkill și pierzi timp configurându-l. Dar la orice volum serios, e singura abordare viabilă pe termen lung.

Voi cum sincronizați starea filtrelor cu URL-ul: mergeți pe nuqs, pe hooks customizate cu useRouter sau încă vă chinuiți cu useState?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

Doar membrii comunității pot lăsa comentarii.