Skip to Content

Trang và layout

Khoảng 10 phút. Làm xong, app của bạn có trang danh sách đơn hàng, trang chi tiết từng đơn và một khung chung có menu.

Mỗi page.tsx là một trang ở URL của thư mục chứa nó, ví dụ app/customers/page.tsx là trang /customers. layout.tsx bọc các trang bên dưới, lồng dần từ gốc xuống.

Trang và layout là file .tsx, chạy trong trình duyệt. App dùng react-router, và manh.run tạo bảng route từ cây thư mục nên bạn không khai báo route nào.

Thư mục thành URL

app/ ├── layout.tsx bọc mọi trang ├── page.tsx / ├── orders/ │ ├── layout.tsx bọc /orders và /orders/:id │ ├── page.tsx /orders │ ├── stats/page.tsx /orders/stats │ └── [id:int]/page.tsx /orders/12 └── (admin)/ ├── layout.tsx bọc /users └── users/page.tsx /users
  • [id:int] là đoạn động có kiểu (int, uuid, slug). Giá trị sai kiểu (/orders/abc) hiện trang 404 có sẵn.
  • Đoạn tĩnh được ưu tiên: /orders/stats vào stats/page.tsx, không vào [id:int]/page.tsx.
  • (admin) là nhóm route: gom file và dùng chung layout, middleware, nhưng không thêm gì vào URL. app/(admin)/users/page.tsx là /users, không phải /admin/users.

Trang

page.tsx export default một component React không nhận props. Tham số URL đọc bằng useParams(), giá trị luôn là chuỗi.

app/orders/[id:int]/page.tsx
import { useParams } from "react-router"; import { PageContainer, ProDescriptions } from "@ant-design/pro-components"; import { useRequest } from "app/hooks"; import { useApiClient } from "app/api"; 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} dataSource={data} columns={[ { title: "Khách hàng", dataIndex: "customerName" }, { title: "Tổng tiền", dataIndex: "total", valueType: "vnd" }, ]} /> </PageContainer> ); }

Trang danh sách và trang chi tiết của một tài nguyên thường dùng <ResourceList> và <ResourceDetail> từ manh/shell, xem Gọi API từ giao diện.

Layout

layout.tsx bọc mọi trang trong thư mục của nó và các thư mục con, theo thứ tự layout gốc → layout con → trang. Mỗi layout phải render <Outlet />, là chỗ trang con hiện ra.

Layout gốc chứa khung app. AppShell từ manh/shell đã gồm tiếng Việt cho antd, App của antd, menu theo vai trò, nút đăng xuất và <Outlet />. Trong file layout, bạn chỉ liệt kê menu:

app/layout.tsx
import { AppShell } from "manh/shell"; import { getUser, signOut } from "app/hooks"; import { APP_THEME } from "app/theme"; export const meta = { siteName: "Spa Hoa Sen", description: "Spa thảo dược ở Huế", lang: "vi" }; const MENU = [ { path: "/", name: "Tổng quan" }, { path: "/orders", name: "Đơn hàng" }, { path: "/users", name: "Người dùng", roles: ["admin"] }, ]; export default function RootLayout() { return <AppShell appName="Spa Hoa Sen" menu={MENU} user={getUser()} onSignOut={signOut} theme={APP_THEME} />; }

Màu, bo góc và chế độ tối lấy từ app/theme.tsx, xem Giao diện. Layout con thường chỉ thêm phần dùng chung cho một nhóm trang:

app/orders/layout.tsx
import { Outlet } from "react-router"; import { Alert } from "antd"; export default function OrdersLayout() { return ( <> <Alert type="info" showIcon message="Đơn sau 17:00 giao vào hôm sau" /> <Outlet /> </> ); }

Meta trang

Trang hoặc layout gốc export một object meta viết thẳng giá trị. Khi deploy, manh.run ghi object này vào <head> của route, nên Google và phần xem trước link trên Zalo, Facebook đọc được mà không cần chạy app.

app/pricing/page.tsx
export const meta = { title: "Bảng giá", // → "Bảng giá · Spa Hoa Sen" description: "Giá gội, massage, liệu trình", image: "https://storage.manh.run/…/public/pricing.jpg", };
  • Khoá của trang: title, description (tối đa 300 ký tự), image (URL https:// tuyệt đối), noindex. Khoá của layout gốc: siteName, description, lang (mặc định vi).
  • Chỉ nhận giá trị viết thẳng. Biến, template ${} và lời gọi hàm bị bỏ qua, check cảnh báo seo.dynamic-meta. Route có tham số dùng <head> của trang chủ.
  • Ảnh: tải lên kho file dưới khoá public/, rồi lấy URL bằng blob.getUrl(key) của manh/blob.
  • App có đăng nhập: đặt meta = { noindex: true } ở app/layout.tsx. Trang công khai (có tên trong danh sách như PUBLIC_PAGES của layout) đặt noindex: false cùng title, description riêng.

Cần biết

  • Layout thiếu <Outlet /> thì trang con không hiện. AppShell đã có sẵn <Outlet />.
  • Không dùng onBack trên PageContainer vì icon quay lại làm trang lỗi. Đặt một Button có ArrowLeftOutlined ở đầu trang.
  • app/(admin)/page.tsx trùng URL với app/page.tsx, check báo duplicate page. Cần trang ở /admin thì dùng thư mục thường app/admin/.
  • App từ 2 trang trở lên mà thiếu app/layout.tsx thì check cảnh báo contract.no-layout.
  • useRoutes() từ app/hooks trả danh sách route đã đăng ký, dùng khi tự dựng menu.

Bước tiếp theo

Cập nhật