Next.js từ cơ bản đến nâng cao
Trang chủ / Module 3
🧭 Module 3 / 18 · 3 ngày 📅 Tuần 1 ●○○○ Dễ

Navigation: Link, prefetch, router, redirect và searchParams

Điều hướng phía client bằng Link, prefetch hoạt động thế nào, useRouter/usePathname/useSearchParams, redirect phía server, state trong URL và trạng thái pending khi chuyển trang.

LinkPrefetchuseRouterredirect
📌 Vì sao module này quan trọng

Điều hướng trong App Router là soft navigation: chỉ phần thay đổi được tải và render, layout giữ nguyên. Hiểu prefetch và cache phía client giải thích vì sao trang "tức thì" — và vì sao đôi khi dữ liệu cũ vẫn hiện sau khi sửa.

🎯 Mục tiêu học tập

  • Dùng <Link> và hiểu prefetch theo mặc định
  • Dùng các hook điều hướng trong Client Component
  • Redirect từ server (redirect, permanentRedirect) và từ config
  • Đọc và cập nhật searchParams cho bộ lọc/phân trang
  • Hiển thị trạng thái pending khi chuyển trang

Link và prefetch

import Link from 'next/link';

<Link href="/blog">Blog</Link>
<Link href={`/blog/${post.slug}`}>{post.title}</Link>
<Link href={{ pathname: '/shop', query: { sort: 'price' } }}>Sắp theo giá</Link>
<Link href="/dashboard" prefetch={false}>Dashboard</Link>   {/* tắt prefetch cho link ít dùng */}
<Link href="/terms" replace scroll={false}>Điều khoản</Link>

Khi <Link> xuất hiện trong viewport (bản production), Next.js prefetch trước: route static thì tải toàn bộ RSC payload; route dynamic thì tải phần tới loading.tsx gần nhất. Bấm vào là có ngay layout và skeleton, phần động stream tiếp. Next.js 16 tối ưu thêm: layout dùng chung chỉ tải một lần, prefetch tăng dần theo phần chưa có trong cache.

Hook điều hướng (Client Component)

'use client';
import { useRouter, usePathname, useSearchParams, useParams } from 'next/navigation';

export function Filters() {
  const router = useRouter();
  const pathname = usePathname();          // '/shop'
  const searchParams = useSearchParams();  // ReadonlyURLSearchParams

  function setSort(sort: string) {
    const params = new URLSearchParams(searchParams);
    params.set('sort', sort);
    params.delete('page');
    router.replace(`${pathname}?${params}`, { scroll: false });
  }
  return <select value={searchParams.get('sort') ?? 'new'} onChange={e => setSort(e.target.value)}>…</select>;
}

router.push/replace/back/refresh/prefetch. router.refresh() yêu cầu server render lại route hiện tại (lấy dữ liệu mới) mà không mất state client. Lưu ý: component dùng useSearchParams trong trang static cần được bọc <Suspense>, nếu không cả trang bị chuyển sang render phía client tới boundary gần nhất.

searchParams ở Server Component

// app/shop/page.tsx
export default async function Shop({ searchParams }: { searchParams: Promise<{ [k: string]: string | string[] | undefined }> }) {
  const sp = await searchParams;
  const page = Number(sp.page ?? 1);
  const sort = typeof sp.sort === 'string' ? sp.sort : 'new';
  const products = await listProducts({ page, sort });
  return <ProductGrid products={products} />;
}

Dùng searchParams làm trang thành dynamic (mỗi query khác nhau là một kết quả khác). Validate bằng Zod vì đây là đầu vào người dùng. Thư viện nuqs giúp quản lý state trong URL có kiểu, dùng được cả server và client.

Redirect

import { redirect, permanentRedirect } from 'next/navigation';

export default async function OldProfile({ params }: { params: Promise<{ id: string }> }) {
  const { id } = await params;
  const user = await getUser(id);
  if (!user) redirect('/login');                 // 307 (hoặc 303 trong Server Action)
  permanentRedirect(`/u/${user.handle}`);        // 308 — SEO chuyển hạng sang URL mới
}
// next.config.ts — redirect hàng loạt không cần code
export default {
  async redirects() {
    return [{ source: '/old-blog/:slug', destination: '/blog/:slug', permanent: true }];
  },
};

redirect() hoạt động bằng cách ném lỗi đặc biệt — đừng đặt nó trong try/catch (sẽ bị nuốt), hoặc re-throw nếu bắt lỗi chung.

Trạng thái pending khi chuyển trang

'use client';
import Link, { useLinkStatus } from 'next/link';

function PendingDot() {
  const { pending } = useLinkStatus();     // phải nằm bên trong <Link>
  return pending ? <span className="spinner" aria-hidden /> : null;
}
export function NavItem({ href, children }: { href: string; children: React.ReactNode }) {
  return <Link href={href}>{children} <PendingDot /></Link>;
}

Với route dynamic không có loading.tsx, người dùng bấm link mà không thấy gì xảy ra cho tới khi server trả về — luôn có loading.tsx hoặc chỉ báo pending.

🚩 Sai lầm hay gặp

  • Dùng <a href> cho link nội bộ → tải lại toàn trang.
  • Đặt redirect() trong try/catch.
  • Quên bọc component dùng useSearchParams bằng <Suspense> trong trang static.

🏋️ Bài tập thực hành

Cửa hàng có bộ lọc trong URL

Trang /shop đọc searchParams ở server (danh mục, giá, sắp xếp, trang), bộ lọc là Client Component cập nhật URL bằng router.replace. Có chỉ báo pending, loading.tsx, redirect /products/:id cũ sang /shop/:slug bằng config.

📚 Tài nguyên học tập

✅ Tự đánh giá hoàn thành

  • Tôi giải thích được prefetch khác nhau với route static và dynamic
  • Tôi cập nhật được searchParams mà không mất các tham số khác
  • Tôi phân biệt được redirect và permanentRedirect
  • Tôi biết vì sao redirect không được nằm trong try/catch