<resource>-columns.tsx
<resource>-columns.tsx khai báo cột của một resource một lần, dùng chung cho bảng ProTable, form BetaSchemaForm và trang chi tiết ProDescriptions.
app/orders/
├── orders-columns.tsx # cột của đơn hàng
├── page.tsx # <ResourceList columns={orderColumns} />
└── [id:int]/
└── page.tsx # <ResourceDetail columns={orderColumns} />Vai trò
Ba component của pro-components đọc cùng một kiểu cột. Viết cột một lần thì nhãn, định dạng tiền, trạng thái và luật kiểm của form giống nhau ở mọi màn hình. Thêm một trường là sửa một chỗ.
Đuôi là .tsx vì cột thường có hàm render trả JSX. File chạy trong trình duyệt.
Export
- Mảng cột kiểu
ProFormColumnsType<T>[], ví dụorderColumns. - Kiểu dòng
Tnếu trang cần (Order).
Các khoá hay dùng: title, dataIndex, valueType (text, vnd, vnDate, select, dateTime…), valueEnum, formItemProps.rules, hideInForm, hideInSearch, hideInTable.
Ví dụ
import type { ProFormColumnsType } from "@ant-design/pro-components";
import { OrderStatus } from "app/shared/order";
export type Order = { id: number; customerName: string; total: number; status: string; createdAt: number };
export const orderColumns: ProFormColumnsType<Order>[] = [
{ title: "Mã", dataIndex: "id", hideInForm: true, hideInSearch: true, width: 80 },
{ title: "Khách hàng", dataIndex: "customerName",
formItemProps: { rules: [{ required: true, max: 200 }] } },
{ title: "Tổng tiền", dataIndex: "total", valueType: "vnd",
formItemProps: { rules: [{ required: true }] } },
{ title: "Trạng thái", dataIndex: "status", valueType: "select",
valueEnum: OrderStatus.valueEnum, hideInForm: true },
{ title: "Tạo lúc", dataIndex: "createdAt", valueType: "dateTime", hideInForm: true, hideInSearch: true },
];<ResourceList> và <ResourceDetail> từ manh/shell đọc file này để dựng bảng, form thêm và sửa, trang chi tiết. Trang tự dựng thì truyền columns={orderColumns} cho ProTable, BetaSchemaForm và ProDescriptions.
vnd hiện số tiền kiểu 1.250.000 ₫, vnDate hiện ngày 13/11/2026. Hai kiểu này do AppShell đăng ký.
Cần biết
- Danh sách trạng thái lấy từ
defineEnumtrongapp/shared/, đừng chép lạivalueEnumtrong file cột. Đổi một nhãn là mọi màn hình đổi theo. - File cột không import
app/dbhay*.table.ts. Kiểu dòng viết lại ở đây hoặc đặt trongapp/shared/. - Không dùng
ProTablecho mọi màn hình. Hộp duyệt việc, kanban, lịch đặt chỗ nên dựng riêng. - Trường ngày có
fieldProps.formatgửi đi chuỗi đã định dạng; thêmtransformđổi vềYYYY-MM-DD.
Bước tiếp theo
- Trang danh sách — dùng file cột cho bảng có tab trạng thái, tìm kiếm, phân trang.
- Form — luật kiểm, trường phụ thuộc nhau và trường ngày.
- shared/ —
defineEnumcho danh sách trạng thái mà cột đọc vào.