Skip to content

Server Component và Client Component ​

Trong App Router, mỗi component mặc định chạy trên server; chỉ component có dòng "use client" ở đầu file mới chạy ở trình duyệt. Trang này mô tả cách dự án chia vai giữa hai loại, để bạn biết nên viết component mới theo hướng nào.

Nguyên tắc dự án đang theo ​

Các trang công khai được tách làm hai file:

  • page.tsx là Server Component: kiểm tra ngôn ngữ, tạo metadata, lấy dữ liệu ban đầu.
  • *-page-client.tsx là Client Component: phần giao diện có tương tác.
TrangServer ComponentClient Component
Trang chủ(main)/page.tsxhome-page-client.tsx
Danh sách việc làmjobs/page.tsxjobs-page-client.tsx
Chi tiết việc làmjobs/[id]/page.tsxjob-detail-page-client.tsx
Danh sách công tycompanies/page.tsxcompanies-page-client.tsx
Chi tiết công tycompanies/[id]/page.tsxcompany-detail-page-client.tsx

Trang việc làm bên ngoài (jobs/external/[id]) là ngoại lệ: server lấy dữ liệu, làm sạch mô tả HTML rồi render thẳng ExternalJobDetailContent, không có file *-page-client.tsx đi kèm.

Việc server làm trong page.tsx ​

  1. Đọc params và searchParams (đều là Promise trong Next.js 15).
  2. Kiểm tra ngôn ngữ bằng hasLocale; sai thì gọi notFound().
  3. Tạo metadata bằng generateMetadata. Xem Rendering và SEO.
  4. Gọi hàm fetchPublic* để lấy dữ liệu ban đầu, rồi truyền xuống Client Component qua props.

Nhóm trang dùng Client Component hoàn toàn ​

Có 25 file dưới src/app/ bắt đầu bằng "use client". Phần lớn là:

  • Các trang cần trạng thái đăng nhập: toàn bộ nhóm (auth), sáu trang admin/* (users, jobs, companies, resumes, personal-info, change-password), profile/page.tsx, account/cancel-deletion.
  • Các layout có guard hoặc trạng thái giao diện: (auth)/layout.tsx, và phần giao diện của (dashboard), (hr-dashboard), (profile)/profile (file *-layout-client.tsx). Bản thân layout.tsx của ba nhóm sau là Server Component, chỉ nạp đủ messages dịch. Xem Đa ngôn ngữ.
  • Các trang lỗi: error.tsx và global-error.tsx (Next.js bắt buộc là Client Component), cùng not-found.tsx (ở đây cũng khai báo client).

Hai trang tổng quan /admin và /hr/dashboard vẫn là Server Component: chúng chỉ tạo metadata rồi render một component thống kê chạy ở trình duyệt.

Lý do thực tế: trạng thái đăng nhập nằm trong Redux ở trình duyệt, nên các trang phụ thuộc vào nó phải chạy ở trình duyệt. Chi tiết ở Xác thực.

Lưu ý khi thêm component ​

  • Cần useState, useEffect, hook Redux hoặc sự kiện trình duyệt thì thêm "use client".
  • Trang công khai cần SEO thì giữ page.tsx là Server Component và đẩy phần tương tác xuống file client riêng.
  • Dữ liệu truyền từ server xuống client qua props phải tuần tự hóa được; không truyền hàm hoặc đối tượng có phương thức.

Source code liên quan ​

Tài liệu kỹ thuật xây dựng theo chuẩn Documentation as Code