Routing với React Router
Cấu hình route, nested layout, tham số động, loader/action, lazy route, bảo vệ route, và đưa state vào URL (lọc, phân trang).
URL là một phần của giao diện: người dùng copy link, bấm Back, mở tab mới. Ứng dụng giữ bộ lọc trong state thay vì URL sẽ mất trạng thái khi reload và không chia sẻ được. Router còn quyết định data được tải khi nào — ảnh hưởng trực tiếp tới tốc độ.
🎯 Mục tiêu học tập
- Cấu hình route lồng nhau với layout và
Outlet - Đọc tham số động và query string
- Dùng loader để tải dữ liệu song song trước khi render, tránh waterfall
- Lazy load route để giảm bundle
- Lưu bộ lọc/phân trang vào URL
Ba chế độ của React Router v7
| Chế độ | Mô tả | Dùng khi |
|---|---|---|
| Declarative | <BrowserRouter> + <Routes> | App nhỏ, chỉ cần điều hướng |
| Data | createBrowserRouter + loader/action | SPA cần tải dữ liệu theo route |
| Framework | Như Remix: file routes, SSR, type-safe | Cần SSR/SEO (cân nhắc thêm Next.js) |
Thư viện thay thế đáng chú ý: TanStack Router (type-safe toàn bộ params và search params).
Route lồng nhau và layout
import { createBrowserRouter, RouterProvider, Outlet, NavLink, useParams } from 'react-router';
const router = createBrowserRouter([
{
path: '/',
element: <RootLayout />,
errorElement: <ErrorPage />,
children: [
{ index: true, element: <Home /> },
{
path: 'products',
children: [
{ index: true, element: <ProductList />, loader: productsLoader },
{ path: ':productId', element: <ProductDetail />, loader: productLoader },
],
},
{ path: 'admin', lazy: () => import('./routes/admin') }, // tách bundle
{ path: '*', element: <NotFound /> },
],
},
]);
function RootLayout() {
return (
<>
<nav><NavLink to="/products" className={({ isActive }) => isActive ? 'active' : ''}>Sản phẩm</NavLink></nav>
<main><Outlet /></main> {/* route con render ở đây */}
</>
);
}
createRoot(root).render(<RouterProvider router={router} />);
Loader: tải dữ liệu trước khi render
export async function productLoader({ params, request }: LoaderFunctionArgs) {
const res = await fetch(`/api/products/${params.productId}`, { signal: request.signal });
if (res.status === 404) throw new Response('Không tìm thấy', { status: 404 });
return res.json();
}
function ProductDetail() {
const product = useLoaderData() as Product;
const navigation = useNavigation(); // 'idle' | 'loading' | 'submitting'
return <div style={{ opacity: navigation.state === 'loading' ? 0.6 : 1 }}>{product.name}</div>;
}
Lợi ích: loader của route cha và con chạy song song ngay khi URL đổi. Fetch trong useEffect của
từng component thì cha render xong con mới bắt đầu fetch → waterfall. Kết hợp TanStack Query: loader gọi
queryClient.ensureQueryData(...) để vừa tải sớm vừa có cache.
State trong URL
function ProductList() {
const [params, setParams] = useSearchParams();
const page = Number(params.get('page') ?? 1);
const sort = params.get('sort') ?? 'newest';
const setPage = (p: number) => setParams(prev => { prev.set('page', String(p)); return prev; });
const setSort = (s: string) => setParams(prev => { prev.set('sort', s); prev.set('page', '1'); return prev; });
// ...
}
Đưa vào URL: bộ lọc, sắp xếp, trang, tab đang mở, từ khoá tìm kiếm. Không đưa: dữ liệu nhạy cảm, state tạm (đang mở dropdown), dữ liệu lớn.
Bảo vệ route
async function requireUser({ request }: LoaderFunctionArgs) {
const user = await getCurrentUser();
if (!user) {
const from = new URL(request.url).pathname;
throw redirect(`/login?from=${encodeURIComponent(from)}`);
}
return user;
}
{ path: 'account', loader: requireUser, element: <Account /> }
Ẩn route ở frontend không phải bảo mật — người dùng vẫn gọi API trực tiếp được. Server luôn phải kiểm tra quyền trên từng request.
🚩 Sai lầm hay gặp
- Dùng
<a href>cho điều hướng nội bộ → reload toàn trang, mất state. - Fetch trong effect của từng route con tạo waterfall.
- Validate
redirectsau đăng nhập không kỹ → open redirect (?from=https://evil.com). Chỉ cho phép đường dẫn nội bộ.
🏋️ Bài tập thực hành
Trang danh sách (lọc, sắp xếp, phân trang lưu trong URL), trang chi tiết, trang giỏ hàng, trang tài khoản cần đăng nhập, trang 404, trang lỗi. Lazy load khu vực admin, kiểm tra bundle tách ra trong tab Network.
📚 Tài nguyên học tập
-
React Router docsTài liệu chính thứcDocs
-
TanStack RouterRouter type-safeLibrary
✅ Tự đánh giá hoàn thành
- Tôi cấu hình được nested routes với layout
- Tôi giải thích được vì sao loader tránh được waterfall
- Tôi lưu được bộ lọc/phân trang trong URL
- Tôi biết vì sao bảo vệ route ở client không phải bảo mật