Skip to Content

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 ProTableDanh 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.
ví-dụ.manh.run · dữ liệu mẫuMở để sửa ↗
Ví dụ chạy khi bạn cuộn 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.

app/requests/page.tsx
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: false cho cột tính toán hoặc chữ dài.
  • hideInTable: true cho field chỉ dùng để lọc, như khoảng ngày.
  • Dùng valueEnum / valueType thay cho render khi 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.

app/requests/page.tsx
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.

app/requests/page.tsx
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.

app/requests/page.tsx
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 đặt scroll={{ 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ẻDanh sách dạng thẻ: lưới Card (title, tag, avatar, mô tả, tiến độ, thao tác khi hover).
ví-dụ.manh.run · dữ liệu mẫuMở để sửa ↗
Ví dụ chạy khi bạn cuộn 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:

app/requests/page.tsx
<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

Cập nhật