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/statsvàostats/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.tsxlà/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.
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:
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:
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.
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(URLhttps://tuyệt đối),noindex. Khoá của layout gốc:siteName,description,lang(mặc địnhvi). - Chỉ nhận giá trị viết thẳng. Biến, template
${}và lời gọi hàm bị bỏ qua,checkcảnh báoseo.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ằngblob.getUrl(key)củamanh/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_PAGEScủa layout) đặtnoindex: falsecùngtitle,descriptionriê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
onBacktrênPageContainervì icon quay lại làm trang lỗi. Đặt mộtButtoncóArrowLeftOutlinedở đầu trang. app/(admin)/page.tsxtrùng URL vớiapp/page.tsx,checkbáoduplicate page. Cần trang ở/adminthì dùng thư mục thườngapp/admin/.- App từ 2 trang trở lên mà thiếu
app/layout.tsxthìcheckcảnh báocontract.no-layout. useRoutes()từapp/hookstrả danh sách route đã đăng ký, dùng khi tự dựng menu.
Bước tiếp theo
- Giao diện — đổi màu, bo góc, chế độ tối cho cả app trong
app/theme.tsx. - Khung app và đầu trang — menu theo vai, đầu trang, nút quay lại.
- page.tsx và layout.tsx — mọi export, đoạn động và khoá
meta.