Skip to Content

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.tsx

Vai 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 định vi), noindex. noindex: true ở đây áp cho mọi trang; trang công khai mở lại bằng noindex: 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.
  • AppShell nhận theme={APP_THEME} từ theme.tsx. Nếu tự dựng khung bằng ConfigProvider và đặt theme, hãy đọc APP_THEME để chủ app vẫn đổi được giao diện.
  • AppShell cũng đăng ký kiểu cột vnd và vnDate cho 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.tsx thì check cảnh báo contract.no-layout: người dùng không có menu và nút đăng xuất.
  • useRoutes() từ app/hooks trả danh sách route đã đăng ký, dùng để dựng menu.

Bước tiếp theo

Cập nhật