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

Cum legi shadcn/ui DataTable cu TanStack Table la server în Next.js fără bătăi de cap

De Cosmin Rotaru, 30 oct. 2026 · 16 vizualizări · 2 like-uri

Postat 30 oct. 2026
typescript
import { useReactTable, getCoreRowModel, type PaginationState } from "@tanstack/react-table"
import { useQueryState, parseAsInteger } from "nuqs"

export function useServerTableState(pageCount: number) {
  const [page, setPage] = useQueryState("page", parseAsInteger.withDefault(1))
  const [perPage, setPerPage] = useQueryState("limit", parseAsInteger.withDefault(10))

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

  const onPaginationChange = (updater: any) => {
    const next = typeof updater === "function" ? updater(pagination) : updater
    setPage(next.pageIndex + 1)
    setPerPage(next.pageSize)
  }

  return { pagination, onPaginationChange, pageCount }
}

Toată lumea copiază exemplul de DataTable din documentația shadcn/ui, vede că merge frumos cu 20 de rânduri mockuite în client și zice că treaba e gata. Am făcut și eu asta anul trecut pe un dashboard B2B, până când am atins vreo 140.000 de comenzi în Postgres, iar browserul clienților îngheța instant când descărca 45MB de JSON la fiecare render.

Soluția e evidentă: server-side pagination, sorting și filtering. Problema e că TanStack Table v8 e gândit inițial ca un motor client-side, iar legarea lui cu URL search params în Next.js App Router te poate băga în niște loop-uri de re-render infinite dacă nu ești atent.

URL-ul ca single source of truth

Cea mai mare greșeală pe care am văzut-o (și pe care am făcut-o și eu la început) e să ții starea de paginare atât în useState din componentă, cât și în search params. Ajungi să ai race conditions între router.push și actualizarea stării interne a tabelului.

Regula mea de aur acum: TanStack Table nu deține starea, doar o reflectă. Paginarea, coloana pe care se face sortarea și termenul de căutare trăiesc exclusiv în query string (?page=2&sort=created_at.desc&q=acme). Folosesc nuqs (fostul next-usequerystate) pentru că serializează totul curat și face shallow routing automat, fără să declanșeze full page reload.

Cum legi state-ul din TanStack la Server Component

În App Router, ai două variante:

  1. Server Component care citește searchParams, face query-ul în DB și trimite datele ca props într-un Client Component care randează tabelul shadcn.
  2. Client Component cu React Query (TanStack Query) care apelează un Route Handler sau Server Action.

Pentru tabele interne de admin, varianta 1 e sfântă. Ai SEO dacă ai nevoie, nu ai waterfall de fetch-uri în client, iar încărcarea inițială e extrem de rapidă. La proiectul de care ziceam, trecerea de la client-side la server-driven a tăiat First Contentful Paint de la 4.2 secunde la 450ms pe conexiuni 4G.

Trade-off-uri de care te lovești

Merge impecabil dacă ai tabele standard de listare date. E nasol însă în două situații:

  • Filtre dependente și instant search: dacă vrei debounce pe un input de search la fiecare 300ms, Server Components pot da senzația de lag dacă serverul e la 100ms latență de client. Aici un spinner discret în useTransition e obligatoriu, altfel UI-ul pare înghețat.
  • Row selection persistent: dacă userul selectează 3 rânduri pe pagina 1, trece pe pagina 2 și selectează încă 2, TanStack Table le va uita pe cele de pe prima pagină dacă schimbi datele complet din server. Trebuie să gestionezi rowSelection separat, păstrând doar ID-urile într-un Set.

Tu cum sincronizezi tabelele mari în App Router: preferi Server Components cu searchParams sau lași totul pe client cu React Query și un Route Handler separat?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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