Skip to Content

Khung app và đầu trang

Dựng khung app bằng AppShell, gồm menu theo vai trò, tài khoản và nút đăng xuất. Dựng đầu mỗi trang bằng PageContainer, gồm tiêu đề, trạng thái, tóm tắt, số chính và nút quyết định.

Khung là phần người dùng thấy ở mọi trang sau khi đăng nhập: logo, menu, tài khoản. Đầu trang cho biết người dùng đang ở đâu và làm được gì. Cả hai đều dựng bằng prop của component Pro, không cần viết CSS.

Khung app ProLayoutKhung app: ProLayout mix + menu nhóm 3 cấp + app launcher 9 chấm + icon header + avatar.
ví-dụ.manh.run · dữ liệu mẫuMở để sửa ↗
Ví dụ chạy khi bạn cuộn tới

Vị trí trong cây app

Khung là AppShell từ manh/shell, đặt trong app/layout.tsx. Trang đăng nhập và đăng ký tự hiện không có khung.

app/ ├── layout.tsx AppShell: menu, vai trò, người đang đăng nhập ├── theme.tsx màu chính, bo góc, chế độ tối ├── login/page.tsx trang công khai, không có khung └── requests/page.tsx trang trong khung, mở đầu bằng PageContainer

Dựng khung bằng AppShell

app/layout.tsx chỉ khai báo khung có gì. Menu theo vai trò, nút đăng xuất, tiếng Việt và giao diện đã có sẵn trong AppShell.

app/layout.tsx
import { AppShell } from "manh/shell"; import { DashboardOutlined, FileTextOutlined, TeamOutlined } from "@ant-design/icons"; import { getUser, signOut } from "app/hooks"; import { APP_THEME } from "app/theme"; const MENU = [ { path: "/", name: "Tổng quan", icon: <DashboardOutlined /> }, { path: "/requests", name: "Đề xuất", icon: <FileTextOutlined /> }, { path: "/users", name: "Người dùng", icon: <TeamOutlined />, roles: ["admin"] }, ]; export default function RootLayout() { return ( <AppShell appName="Duyệt mua sắm" menu={MENU} roleLabels={{ admin: "Quản trị", staff: "Nhân viên" }} user={getUser()} onSignOut={signOut} theme={APP_THEME} /> ); }
  • roles ẩn mục với người không có vai đó. Nhóm menu viết { name, icon, children: [...] }.
  • count: () => số hiện số việc đang chờ cạnh mục menu, tải lại mỗi lần chuyển trang.
  • Trang chi tiết /requests/12 vẫn làm sáng mục Đề xuất. Người chưa đăng nhập được đưa về /login.

Bỏ khung ở trang công khai

/login và /register không có khung. Trang công khai khác, như form đặt lịch hay tra cứu đơn, liệt kê trong publicPaths. API của trang đó đặt export const access = "public".

app/layout.tsx
const PUBLIC_PATHS = ["/login", "/register", "/dat-lich"]; <AppShell /* … */ publicPaths={PUBLIC_PATHS} />

Cả một nhánh đường dẫn công khai thì dùng isPublic={(p) => p.startsWith("/tra-cuu")}.

Tự dựng khung bằng ProLayout

Cần menu cấp 1 trên thanh trên cùng hay nút chín chấm để chuyển app thì thay AppShell bằng ProLayout của bạn.

app/components/shell.tsx
<ProLayout layout="mix" splitMenus // cấp 1 trên thanh trên cùng, cấp 2–3 bên trái siderMenuType="group" // cấp 2 thành tiêu đề nhóm, cấp 3 thành mục menu={{ collapsedShowGroupTitle: true, locale: false }} route={{ path: "/", children: [ { path: "/ops", name: "Vận hành", icon: <AppstoreOutlined />, children: [ { path: "/ops/orders", name: "Đơn hàng", children: [{ path: "/ops/orders/all", name: "Tất cả đơn" }] }, ] }, ] }} appList={[ // nút chín chấm cạnh logo { title: "Nội bộ", desc: "Ứng dụng của công ty", children: [ { title: "CRM", desc: "Khách hàng và cơ hội", icon: <TeamOutlined />, url: "https://crm.example.vn", target: "_blank" }, ] }, ]} menuFooterRender={(p) => (p?.collapsed ? undefined : <div>v1.0</div>)} location={{ pathname }} menuItemRender={(item, dom) => <a onClick={() => item.path && nav(item.path)}>{dom}</a>} />
  • menuItemRender và location là bắt buộc: thiếu chúng thì bấm menu không chuyển trang, không mục nào sáng.

  • appList: mục có children hiện thành nhóm có tiêu đề. Khi mọi mục đều có desc, bảng chọn app hiện dạng thẻ lớn, nếu không thì hiện lưới icon gọn.

  • splitMenus chỉ có nghĩa khi layout="mix". Mục đang chọn trên thanh trên cùng tính từ location.pathname.

  • breakpoint (mặc định lg) tự thu gọn menu trái; muốn tự điều khiển thì dùng collapsed + onCollapse.

Đầu trang bằng PageContainer

Mỗi trang trong khung mở đầu bằng PageContainer. Mỗi loại thông tin ở đầu trang có một prop riêng:

app/requests/[id:int]/page.tsx
<PageContainer header={{ title: r.title, breadcrumb: { items: [{ title: <a onClick={() => nav("/requests")}>Đề xuất</a> }, { title: `#${r.id}` }] }, tags: <Tag color="processing">Chờ duyệt</Tag>, extra: <FlowActions flow={RequestFlow} record={r} labels={RequestStatus} move={move} onDone={refresh} />, }} content={<ProDescriptions column={{ xs: 1, sm: 2, lg: 4 }}>{/* 3–4 thông tin chính */}</ProDescriptions>} extraContent={<Statistic title="Số tiền đề xuất" value={vnd(r.amount)} />} // con số quan trọng nhất > {/* … */} </PageContainer>
  • content là dải tóm tắt dưới tiêu đề; extraContent là 1–3 con số canh phải.
  • header.extra là các nút chuyển trạng thái. FlowActions chỉ hiện những bước người đang đăng nhập được làm, xem Trang chi tiết.
  • Trang có nhiều phần như thông tin, lịch sử, mục liên quan: dùng tabList + tabActiveKey + onTabChange.
  • Dashboard: title là lời chào, subTitle là số việc cần làm (“2 đề xuất đang chờ bạn duyệt”), một nút chính ở extra.

Cần biết

  • Không dùng onBack trên PageContainer vì trang sẽ sập. Dùng header.breadcrumb.
  • Không tự ghép Layout.Sider + Menu, không ghi đè class .ant-pro-*, không để SettingDrawer trong bản chạy thật.
  • Màu khung lấy từ app/theme.tsx. Khung tự dựng thì dùng token của ProLayout, không gõ mã màu.

Bước tiếp theo

Cập nhật