Ứng dụng một trang (SPA) vẫn cần nhiều "trang" với đường dẫn riêng. React Router xử lý việc này phía trình duyệt mà không tải lại trang. Bài này hướng dẫn khai báo route, liên kết, tham số và layout lồng nhau.

55 phútTrung cấp
Bạn sẽ học được
  • Cài và cấu hình React Router
  • Tạo liên kết bằng Link, NavLink
  • Đọc tham số đường dẫn
  • Layout dùng chung với Outlet

Cơ sở lý thuyết

Định tuyến phía máy khách (client-side routing): trong SPA, khi người dùng chuyển trang, JavaScript chặn điều hướng mặc định, đổi URL bằng History API (history.pushState) và hiển thị component tương ứng mà không tải lại toàn trang – nhanh và giữ được trạng thái.

  • URL vẫn phải có ý nghĩa: người dùng có thể đánh dấu, chia sẻ, bấm nút Quay lại.
  • Tham số động (/sinh-vien/:ma) và chuỗi truy vấn (?trang=2&lop=K66) – nên lưu trạng thái lọc, phân trang vào URL để chia sẻ được.
  • Tuyến lồng nhau và Outlet: bố cục chung (menu, chân trang) giữ nguyên, chỉ phần nội dung thay đổi.
  • Tuyến được bảo vệ: chuyển hướng về đăng nhập nếu chưa xác thực (chỉ là trải nghiệm – bảo mật thật nằm ở API).
  • Máy chủ phải trả index.html cho mọi đường dẫn (fallback), nếu không tải lại trang ở /sinh-vien/5 sẽ lỗi 404.
  • Tách mã theo tuyến (lazy loading) để mỗi trang chỉ tải mã cần thiết.

Cài đặt

npm install react-router

Khai báo route

import { BrowserRouter, Routes, Route, Link, Outlet, useParams } from "react-router";

function Layout() {
  return (
    <>
      <nav><Link to="/">Trang chủ</Link> | <Link to="/sinh-vien">Sinh viên</Link></nav>
      <Outlet />
    </>
  );
}

function ChiTiet() {
  const { ma } = useParams();
  return <h2>Sinh viên {ma}</h2>;
}

export default function App() {
  return (
    <BrowserRouter>
      <Routes>
        <Route element={<Layout />}>
          <Route path="/" element={<h1>Trang chủ</h1>} />
          <Route path="/sinh-vien" element={<h1>Danh sách</h1>} />
          <Route path="/sinh-vien/:ma" element={<ChiTiet />} />
          <Route path="*" element={<h1>Không tìm thấy</h1>} />
        </Route>
      </Routes>
    </BrowserRouter>
  );
}

Ghi chú

  • Link chuyển trang không tải lại; NavLink tự thêm lớp active cho mục đang chọn.
  • useNavigate() chuyển trang bằng mã, ví dụ sau khi lưu form.
  • Khi triển khai, máy chủ cần chuyển mọi đường dẫn về index.html.

Ứng dụng thực tế

Bài toán: ứng dụng quản lý đào tạo có trang công khai và khu quản trị cần đăng nhập, trang chi tiết đọc mã sinh viên từ URL, khu quản trị chỉ tải mã khi cần:

import { BrowserRouter, Routes, Route, Navigate, Outlet, useParams } from "react-router";
const QuanTri = lazy(() => import("./QuanTri"));          // tách mã: tải khi vào /quan-tri

function CanDangNhap() {
  const { nguoiDung } = useXacThuc();
  return nguoiDung ? <Outlet /> : <Navigate to="/dang-nhap" replace />;
}
function ChiTiet() {
  const { ma } = useParams();                              // /sinh-vien/2610010001
  return <HoSo ma={ma} />;
}
export default function App() {
  return (
    <BrowserRouter>
      <Suspense fallback={<p>Đang tải...</p>}>
        <Routes>
          <Route path="/" element={<BoCuc />}>
            <Route index element={<TrangChu />} />
            <Route path="sinh-vien/:ma" element={<ChiTiet />} />
            <Route element={<CanDangNhap />}>
              <Route path="quan-tri/*" element={<QuanTri />} />
            </Route>
            <Route path="*" element={<p>Không tìm thấy trang</p>} />
          </Route>
        </Routes>
      </Suspense>
    </BrowserRouter>
  );
}
Lưu ý

Từ phiên bản 7, gói chính là react-router (react-router-dom vẫn dùng được). Tài liệu cũ dùng Switch và component= thuộc phiên bản 5.

Thực hành
  1. Tạo 3 trang: Trang chủ, Danh sách, Giới thiệu với menu chung.
  2. Thêm trang chi tiết /sinh-vien/:ma.
  3. Thêm trang 404.
Tóm tắt bài học
  • Routes + Route khai báo các trang.
  • Link chuyển trang, useParams đọc tham số.
  • Outlet hiển thị trang con trong layout.