layout.tsx
layout.tsx bọc mọi trang trong thư mục của nó và các thư mục con, và phải render <Outlet /> để trang con hiện ra.
app/
├── layout.tsx # bọc mọi trang
├── orders/
│ ├── layout.tsx # bọc /orders và /orders/:id
│ ├── page.tsx
│ └── [id:int]/page.tsx
└── (admin)/
├── layout.tsx # bọc /users và /products
├── users/page.tsx
└── products/page.tsxVai trò
Layout lồng nhau từ gốc xuống: layout gốc, rồi layout của thư mục con, rồi trang. <Outlet /> là chỗ phần bên trong hiện ra.
Layout gốc app/layout.tsx giữ khung app. AppShell từ manh/shell đã gồm ngôn ngữ tiếng Việt cho antd, App của antd, theme, menu theo vai trò, nút đăng xuất và <Outlet />, nên layout gốc chỉ khai báo menu. Layout con thêm phần chung của một nhóm trang, ví dụ một thông báo hay một thanh tab. Nhóm (admin) cho nhiều trang dùng chung layout mà không thêm đoạn nào vào URL.
Export
default: component React, render<Outlet />từreact-router.meta(chỉ ở layout gốc, tuỳ chọn):siteName,description,lang(mặc địnhvi),noindex.noindex: trueở đây áp cho mọi trang; trang công khai mở lại bằngnoindex: false.
Ví dụ
app/layout.tsx
import { AppShell } from "manh/shell";
import { ADMIN_ROLE } from "app/shared/auth-roles";
import { getUser, signOut } from "app/hooks";
import { APP_THEME } from "app/theme";
import { DashboardOutlined, ShoppingCartOutlined, TeamOutlined } from "@ant-design/icons";
export const meta = { siteName: "Kho Hoà Phát", lang: "vi", noindex: true };
const MENU = [
{ path: "/", name: "Tổng quan", icon: <DashboardOutlined /> },
{ path: "/orders", name: "Đơn hàng", icon: <ShoppingCartOutlined /> },
{ path: "/users", name: "Người dùng", icon: <TeamOutlined />, roles: [ADMIN_ROLE] }, // chỉ admin thấy
];
export default function RootLayout() {
return <AppShell appName="Kho Hoà Phát" menu={MENU} user={getUser()} onSignOut={signOut} theme={APP_THEME} />;
}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 />
</>
);
}Cần biết
- Thiếu
<Outlet />thì trang con không hiện. AppShellnhậntheme={APP_THEME}từ theme.tsx. Nếu tự dựng khung bằngConfigProvidervà đặttheme, hãy đọcAPP_THEMEđể chủ app vẫn đổi được giao diện.AppShellcũng đăng ký kiểu cộtvndvàvnDatecho bảng, hiện tiền và ngày theo kiểu Việt Nam.- App có từ 2 trang mà không có
app/layout.tsxthìcheckcảnh báocontract.no-layout: người dùng không có menu và nút đăng xuất. useRoutes()từapp/hookstrả danh sách route đã đăng ký, dùng để dựng menu.
Bước tiếp theo
- Khung app và đầu trang — chỉnh menu, đầu trang và nhóm menu của
AppShell. - theme.tsx — đổi màu chính, bo góc và dark mode cho cả app.
- Trang và layout — nhóm route và
metacho từng trang.
Cập nhật