Trang danh sách
Trang danh sách hiện nhiều bản ghi, cho tìm kiếm, lọc theo trạng thái và chọn nhiều dòng để xử lý cùng lúc. Dựng trang bằng ProTable.
Đây là nơi người dùng làm việc hằng ngày: người duyệt mở danh sách đề xuất, lọc những cái đang chờ, chọn vài cái rồi duyệt cùng lúc. ProTable có sẵn ô tìm kiếm, phân trang, chọn nhiều dòng và thanh công cụ, nên bạn chỉ khai báo cột và cách tải dữ liệu.
// Danh sách: ProTable với form tìm kiếm, tab trạng thái có số đếm, chọn nhiều để duyệt, valueEnum dạng Badge.
// Trong app thật: request gọi api.<resource>.list(...) và trả { data, total, success: true }.
import { useMemo, useRef, useState } from "react";
import { PageContainer, ProTable, type ActionType, type ProColumns } from "@ant-design/pro-components";
import { App, Badge, Button, Popconfirm, Space, Typography } from "antd";
import { CheckOutlined, PlusOutlined } from "@ant-design/icons";
type Status = "pending" | "approved" | "rejected";
type Row = { id: number; title: string; amount: number; owner: string; dept: string; status: Status; category: string; createdAt: string };
const STATUS = {
pending: { text: "Chờ duyệt", status: "Processing" },
approved: { text: "Đã duyệt", status: "Success" },
rejected: { text: "Từ chối", status: "Error" },
} as const;
const CATEGORY = { office: { text: "Văn phòng phẩm" }, equipment: { text: "Thiết bị" }, software: { text: "Phần mềm" } };
const vnd = (n: number) => `${n.toLocaleString("vi-VN")} ₫`;
const SEED: Row[] = [
{ id: 9, title: "Gia hạn Microsoft 365 (12 tháng, 10 user)", amount: 18600000, owner: "Trần Thị Lan", dept: "Hành chính", status: "pending", category: "software", createdAt: "2026-11-10" },
{ id: 8, title: "2 màn hình Dell P2423 cho team dev", amount: 7800000, owner: "Lê Văn Minh", dept: "Kỹ thuật", status: "pending", category: "equipment", createdAt: "2026-11-09" },
{ id: 7, title: "Giấy in A4 (20 ram)", amount: 2400000, owner: "Trần Thị Lan", dept: "Hành chính", status: "approved", category: "office", createdAt: "2026-11-05" },
{ id: 6, title: "Bàn phím cơ cho dev", amount: 1890000, owner: "Lê Văn Minh", dept: "Kỹ thuật", status: "rejected", category: "equipment", createdAt: "2026-11-02" },
];
export default function Page() {
const { message } = App.useApp();
const ref = useRef<ActionType>(undefined);
const [rows, setRows] = useState(SEED);
const [tab, setTab] = useState<"all" | Status>("pending");
const counts = useMemo(() => ({
all: rows.length,
pending: rows.filter((r) => r.status === "pending").length,
approved: rows.filter((r) => r.status === "approved").length,
rejected: rows.filter((r) => r.status === "rejected").length,
}), [rows]);
const columns: ProColumns<Row>[] = [
{ title: "Tiêu đề", dataIndex: "title", ellipsis: true, fieldProps: { placeholder: "Tìm theo tiêu đề" },
render: (_, r) => (
<Space orientation="vertical" size={0}>
<Typography.Link strong>{r.title}</Typography.Link>
<Typography.Text type="secondary" style={{ fontSize: 12 }}>#{r.id} · {r.createdAt}</Typography.Text>
</Space>
) },
{ title: "Số tiền", dataIndex: "amount", align: "right", search: false, render: (_, r) => <b>{vnd(r.amount)}</b> },
{ title: "Người tạo", dataIndex: "owner", search: false,
render: (_, r) => <Space orientation="vertical" size={0}><span>{r.owner}</span><Typography.Text type="secondary" style={{ fontSize: 12 }}>{r.dept}</Typography.Text></Space> },
{ title: "Trạng thái", dataIndex: "status", valueEnum: STATUS, search: false },
{ title: "Hạng mục", dataIndex: "category", valueType: "select", valueEnum: CATEGORY },
{ title: "Thao tác", valueType: "option", render: () => [<a key="v">Xem</a>] },
];
return (
<PageContainer title="Tất cả đề xuất" subTitle="Duyệt hoặc từ chối đề xuất của nhân viên">
<ProTable<Row>
actionRef={ref}
rowKey="id"
cardBordered
columns={columns}
params={{ tab, rows }}
search={{ labelWidth: "auto", searchText: "Tìm", resetText: "Xoá lọc" }}
pagination={{ pageSize: 10, showTotal: (t) => `${t} đề xuất` }}
request={async (p: Record<string, unknown>) => {
const data = rows
.filter((r) => tab === "all" || r.status === tab)
.filter((r) => !p.title || r.title.toLowerCase().includes(String(p.title).toLowerCase()))
.filter((r) => !p.category || r.category === p.category);
return { data, total: data.length, success: true };
}}
toolbar={{
menu: {
type: "tab",
activeKey: tab,
onChange: (k) => setTab(k as typeof tab),
items: (["all", "pending", "approved", "rejected"] as const).map((k) => ({
key: k,
label: <span>{k === "all" ? "Tất cả" : STATUS[k].text}<Badge count={counts[k]} color={k === "pending" ? "orange" : "#bfbfbf"} style={{ marginInlineStart: 6 }} /></span>,
})),
},
}}
rowSelection={tab === "pending" ? {} : undefined}
tableAlertRender={({ selectedRows }) => <span>Đã chọn <b>{selectedRows.length}</b> · tổng <b>{vnd(selectedRows.reduce((a, r) => a + r.amount, 0))}</b></span>}
tableAlertOptionRender={({ selectedRows, onCleanSelected }) => (
<Space>
<a onClick={onCleanSelected}>Bỏ chọn</a>
<Popconfirm title={`Duyệt ${selectedRows.length} đề xuất?`} onConfirm={() => {
const ids = new Set(selectedRows.map((r) => r.id));
setRows((all) => all.map((r) => (ids.has(r.id) ? { ...r, status: "approved" } : r)));
message.success(`Đã duyệt ${ids.size} đề xuất`);
onCleanSelected();
}}>
<Button type="primary" size="small" icon={<CheckOutlined />}>Duyệt đã chọn</Button>
</Popconfirm>
</Space>
)}
toolBarRender={() => [<Button key="n" type="primary" icon={<PlusOutlined />}>Tạo yêu cầu</Button>]}
/>
</PageContainer>
);
}
Làm màn hình "Danh sách ProTable" cho app của tôi theo mẫu manh.run UI playbook (framework_docs("pro")): Danh sách: ProTable với form tìm kiếm, tab trạng thái có số đếm, chọn nhiều để duyệt, valueEnum dạng Badge. Dữ liệu lấy từ API của app qua useApiClient(); nhãn và trường theo spec của tôi.Khai báo cột một lần
Mỗi cột vừa là cột của bảng, vừa quyết định có ô tìm kiếm tương ứng hay không. Khai báo một mảng columns và dùng lại cho bảng, form tìm kiếm và trang chi tiết.
const columns: ProColumns<Req>[] = [
{ title: "Tiêu đề", dataIndex: "title", ellipsis: true }, // thành ô tìm kiếm
{ title: "Số tiền", dataIndex: "amount", align: "right", search: false,
render: (_, r) => <b>{vnd(r.amount)}</b> },
{ title: "Trạng thái", dataIndex: "status", valueEnum: STATUS, search: false }, // Badge
{ title: "Hạng mục", dataIndex: "category", valueType: "select", valueEnum: CATEGORY },
{ title: "Tạo trong", dataIndex: "createdAt", valueType: "dateRange", hideInTable: true,
search: { transform: (v) => ({ from: v[0], to: v[1] }) } }, // chỉ để lọc
{ title: "Thao tác", valueType: "option", width: 100,
render: (_, r) => [<a key="view" onClick={() => open(r)}>Xem</a>] },
];search: falsecho cột tính toán hoặc chữ dài.hideInTable: truecho field chỉ dùng để lọc, như khoảng ngày.- Dùng
valueEnum/valueTypethay chorenderkhi có thể. Làm vậy thì có sẵn Badge, ô lọc và cách hiển thị ở trang chi tiết.
Tải dữ liệu từ API của app
request gọi API sinh sẵn trong app/api và trả { data, total, success }. Đổi params là bảng tự tải lại.
const api = useApiClient();
<ProTable<Req>
rowKey="id"
columns={columns}
params={{ tab }}
request={async (p) => {
const r = await api.requests.list({
page: p.current, pageSize: p.pageSize,
status: tab === "all" ? undefined : tab,
category: p.category, search: p.title,
});
return { data: r.data, total: r.total, success: true };
}}
pagination={{ pageSize: 20, showTotal: (t) => `${t} đề xuất` }}
/>Nếu tên tham số của bảng khớp với API, tức không phải đổi title thành search hay tab thành status, thì bỏ hàm request viết tay và dùng request={tableRequest(api.requests.list)} từ app/hooks. Danh sách chuẩn gồm tab trạng thái, tìm kiếm, form tạo mới và link sang trang chi tiết thì dùng thẳng ResourceList từ manh/shell, xem Gọi API từ giao diện.
Tab trạng thái có số đếm
Tab có số đếm cho người dùng thấy còn bao nhiêu việc, rõ hơn một ô chọn trạng thái. Lấy số đếm từ một API thống kê. Tab mặc định là việc của người đang đăng nhập, ví dụ người duyệt mở trang là thấy ngay tab Chờ duyệt.
toolbar={{
menu: {
type: "tab",
activeKey: tab,
onChange: (k) => setTab(k as Tab),
items: TABS.map((t) => ({
key: t.key,
label: <span>{t.label} <Badge count={counts?.[t.key]} /></span>,
})),
},
}}Chọn nhiều dòng để xử lý cùng lúc
Chỉ bật rowSelection cho vai trò được phép, và khoá những dòng không còn xử lý được.
rowSelection={canApprove ? { getCheckboxProps: (r) => ({ disabled: r.status !== "pending" }) } : undefined}
tableAlertRender={({ selectedRows }) => <span>Đã chọn <b>{selectedRows.length}</b> · tổng <b>{vnd(sum(selectedRows))}</b></span>}
tableAlertOptionRender={({ selectedRows, onCleanSelected }) => (
<Space><a onClick={onCleanSelected}>Bỏ chọn</a><BulkApprove rows={selectedRows} /></Space>
)}Cần biết
- Cột thao tác ghim bên phải (
fixed: "right") cần đặtscroll={{ x: 1100 }}trên bảng. - Danh sách cần tự cập nhật thì dùng
polling={5000}(tối thiểu 2000 ms). - Server vẫn phải kiểm quyền và trạng thái khi duyệt. Khoá checkbox chỉ giúp người dùng đỡ bấm nhầm.
Biến thể
Danh sách dạng thẻ. Khi mỗi bản ghi có ảnh hoặc tiến độ, dùng ProList dạng lưới.
// Danh sách dạng thẻ: lưới Card (title, tag, avatar, mô tả, tiến độ, thao tác khi hover).
import { PageContainer } from "@ant-design/pro-components";
import { Avatar, Card, Progress, Segmented, Tag } from "antd";
import { useState } from "react";
/** Mock people get a face (manh.run avatars 01–24), the same one for the same name. */
const face = (name: string) => {
let h = 0;
for (const ch of name) h = (h * 31 + ch.charCodeAt(0)) >>> 0;
return `https://manh.run/avatars/${String((h % 24) + 1).padStart(2, "0")}.svg`;
};
const projects = [
{ id: 1, name: "Triển khai CRM", owner: "Lê Văn Minh", tag: "Đang chạy", pct: 72, desc: "Chuyển khách hàng từ Excel sang CRM, đào tạo 12 sales." },
{ id: 2, name: "Kiểm kê kho Q4", owner: "Trần Thị Lan", tag: "Sắp hạn", pct: 40, desc: "Đối soát tồn kho 3 kho trước 30/11." },
{ id: 3, name: "Website tuyển dụng", owner: "Phạm Quốc Bảo", tag: "Hoàn tất", pct: 100, desc: "Trang tuyển dụng mới + form ứng tuyển." },
{ id: 4, name: "Số hoá hợp đồng", owner: "Nguyễn Thu Hà", tag: "Đang chạy", pct: 18, desc: "Scan và gắn nhãn 1.200 hợp đồng cũ." },
];
const TAG_COLOR: Record<string, string> = { "Đang chạy": "processing", "Sắp hạn": "warning", "Hoàn tất": "success" };
export default function Page() {
const [filter, setFilter] = useState("Tất cả");
const data = projects.filter((p) => filter === "Tất cả" || p.tag === filter);
return (
<PageContainer title="Dự án" extra={<Segmented options={["Tất cả", "Đang chạy", "Sắp hạn", "Hoàn tất"]} value={filter} onChange={(v) => setFilter(String(v))} />}>
<div className="grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-3">
{data.map((r) => (
<Card key={r.id} hoverable className="group">
<Card.Meta
avatar={<Avatar src={face(r.owner)} alt={r.owner} />}
title={
<div className="flex flex-wrap items-center gap-2">
<span>{r.name}</span>
<Tag color={TAG_COLOR[r.tag]}>{r.tag}</Tag>
</div>
}
description={r.desc}
/>
<Progress className="!mt-3" percent={r.pct} size="small" status={r.pct === 100 ? "success" : "active"} />
<div className="mt-2 flex justify-end gap-4 opacity-0 transition-opacity group-hover:opacity-100">
<a>Mở</a>
<a>Sửa</a>
</div>
</Card>
))}
</div>
</PageContainer>
);
}
Làm màn hình "Danh sách dạng thẻ" cho app của tôi theo mẫu manh.run UI playbook (framework_docs("pro")): Danh sách dạng thẻ: lưới Card (title, tag, avatar, mô tả, tiến độ, thao tác khi hover). Dữ liệu lấy từ API của app qua useApiClient(); nhãn và trường theo spec của tôi.Danh sách và chi tiết cạnh nhau. Bảng gọn bên trái, chi tiết bên phải:
<ProCard split="vertical">
<ProCard colSpan="384px" ghost>
<ProTable search={false} options={false} columns={columns} request={load}
onRow={(r) => ({ onClick: () => setId(r.id) })} />
</ProCard>
<ProCard title={current?.title}>{/* ProDescriptions + nút duyệt */}</ProCard>
</ProCard>Bảng sửa trực tiếp. Dùng EditableProTable với editable={{ type: "multiple", editableKeys, onChange, onSave }}.
Bước tiếp theo
- Trang chi tiết — bấm Xem ở danh sách thì mở trang này.
- Form — nút Tạo yêu cầu mở form trong Drawer.
- Gọi API từ giao diện —
useApiClient()và API sinh sẵn.