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.
Đ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()trongtry/catch. - Quên bọc component dùng
useSearchParamsbằng<Suspense>trong trang static.
🏋️ Bài tập thực hành
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
-
Next.js — Linking and NavigatingPrefetch, soft navigationDocs
-
nuqsURL state có kiểuLibrary
✅ 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
redirectvàpermanentRedirect - Tôi biết vì sao
redirectkhông được nằm trong try/catch