Skip to Content

page.tsx

page.tsx là một trang của app, hiện ở URL của thư mục chứa nó và chạy trong trình duyệt.

app/ ├── page.tsx # / ├── orders/ │ ├── page.tsx # /orders │ └── [id:int]/ │ └── page.tsx # /orders/:id └── (admin)/ └── users/ └── page.tsx # /users

Vai trò

Mỗi thư mục có page.tsx thành một route của app. URL là đường dẫn thư mục, bỏ app/, bỏ nhóm (group) và bỏ phần kiểu của segment động. manh.run sinh bảng route từ cây thư mục; router là react-router.

Mọi layout.tsx từ gốc xuống tới thư mục của trang bọc lấy trang đó.

Export

  • default: component React của trang. Component không nhận props; đọc tham số URL bằng useParams() từ react-router.
  • meta (tuỳ chọn): title, description, image, noindex. Khi deploy, manh.run ghi các giá trị này vào <head> HTML để công cụ tìm kiếm và bản xem trước link đọc được. Chỉ nhận giá trị viết thẳng: chuỗi, true, false.

Ví dụ

app/orders/[id:int]/page.tsx
import { useParams } from "react-router"; import { PageContainer, ProDescriptions } from "@ant-design/pro-components"; import { useApiClient } from "app/api"; import { useRequest } from "app/hooks"; import { orderColumns } from "../orders-columns"; export const meta = { title: "Chi tiết đơn", noindex: true }; export default function OrderDetailPage() { const { id } = useParams(); const api = useApiClient(); const { data, loading } = useRequest(() => api.orders.detail(Number(id)), { refreshDeps: [id] }); return ( <PageContainer title={`Đơn #${id}`} loading={loading}> <ProDescriptions column={2} columns={orderColumns} dataSource={data} /> </PageContainer> ); }

Cần biết

  • Trang có segment có kiểu được kiểm trước khi render: /orders/abc hiện trang 404 có sẵn. Trong trang, useParams() vẫn trả chuỗi.
  • app/(admin)/page.tsx không hợp lệ vì trùng URL với app/page.tsx. Cần trang ở /admin thì dùng thư mục thường app/admin/page.tsx.
  • Đoạn tĩnh thắng đoạn động: /orders/stats vào stats/page.tsx, không vào [id:int]/page.tsx.
  • Không đặt onBack trên PageContainer: icon quay lại làm trang lỗi. Đặt một Button có ArrowLeftOutlined phía trên.
  • Trang không import app/db, *.table.ts hay manh/env. Dữ liệu lấy qua useApiClient().
  • meta dùng biến hay template ${} bị bỏ qua, check cảnh báo seo.dynamic-meta.

Bước tiếp theo

  • layout.tsx — bọc trang bằng khung app có menu và nút đăng xuất.
  • Gọi dữ liệu — lấy dữ liệu cho trang bằng useApiClient() và useRequest().
  • Trang danh sách — dựng trang danh sách có tab trạng thái, tìm kiếm, phân trang.
Cập nhật