Skip to Content

<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 T nế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ụ

app/orders/orders-columns.tsx
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ừ defineEnum trong app/shared/, đừng chép lại valueEnum trong file cột. Đổi một nhãn là mọi màn hình đổi theo.
  • File cột không import app/db hay *.table.ts. Kiểu dòng viết lại ở đây hoặc đặt trong app/shared/.
  • Không dùng ProTable cho 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.format gửi đi chuỗi đã định dạng; thêm transform đổ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/ — defineEnum cho danh sách trạng thái mà cột đọc vào.
Cập nhật