Skip to Content

ResourceDetail

Trang của một bản ghi từ manh/shell: tiêu đề kèm nhãn trạng thái, các trường lấy từ bộ cột, nút chuyển trạng thái hợp lệ cho vai đang đăng nhập, nút sửa, xoá và các tab.

Cách dùng

app/orders/[id:int]/page.tsx
import { useApiClient } from "app/api"; import { ResourceDetail } from "manh/shell"; import { OrderFlow, OrderStatus } from "app/shared/order"; import { orderColumns } from "../orders-columns"; export default function OrderPage() { const api = useApiClient(); return ( <ResourceDetail api={api.orders} path="/orders" listTitle="Đơn hàng" columns={orderColumns} title={(o) => `Đơn ${o.code}`} status="status" statusEnum={OrderStatus} flow={OrderFlow} move={(to, o, v) => api.orders.status(o.id, { to, ...v })} moveLabels={{ confirmed: "Xác nhận", shipping: "Giao hàng" }} /> ); }

Chữ ký

manh/shell
function ResourceDetail<T = any>(props: { api: { detail: (id: any) => Promise<any>; update?: (id: any, body: any) => Promise<any>; remove?: (id: any) => Promise<any> }; id?: number | string; columns: any[]; title?: (r: T) => ReactNode; path?: string; listTitle?: string; status?: string; statusEnum?: Enum; // từ defineEnum flow?: Flow | ((r: T) => Flow); // từ defineFlow move?: (to: string, r: T, values?: any) => Promise<unknown>; ask?: Record<string, any[]>; moveLabels?: Record<string, string>; actions?: (r: T, reload: () => void) => ReactNode[]; tabs?: { key: string; tab: string; render: (r: T, reload: () => void) => ReactNode }[]; extra?: (r: T) => ReactNode; edit?: boolean | ((r: T) => boolean); remove?: boolean; defaultTab?: string; }): JSX.Element;

Tham số

  • api: nhóm hàm của tài nguyên. Cần detail; có update thì có nút Sửa, có remove và remove={true} thì có nút Xoá.
  • id: id bản ghi; mặc định lấy id trên đường dẫn.
  • columns: cùng bộ cột với ResourceList, dùng cho phần thông tin và form sửa.
  • title(r): tiêu đề trang, mặc định #<id>.
  • path, listTitle: link quay về danh sách và chữ trên link.
  • status, statusEnum: cột trạng thái và enum, hiện nhãn màu cạnh tiêu đề.
  • flow, move: luồng trạng thái và hàm gọi API chuyển trạng thái. Có cả hai thì trang hiện nút cho các bước vai đang đăng nhập được làm. flow có thể là hàm của bản ghi, khi luồng tuỳ theo bản ghi (ví dụ đề xuất trên một mức tiền đi qua thêm một cấp duyệt).
  • ask: các bước cần hỏi thêm trước khi chuyển, ví dụ { lost: [{ title: "Lý do", dataIndex: "reason" }] }. Giá trị form đi vào tham số thứ ba của move.
  • moveLabels: chữ trên nút theo từng bước, ví dụ { done: "Trả máy" }. Mặc định là tên trạng thái đích.
  • actions(r, reload): nút thêm ở đầu trang.
  • tabs: các tab dưới phần thông tin, ví dụ lịch sử, file đính kèm. defaultTab: tab mở sẵn.
  • extra(r): nội dung thêm dưới tiêu đề.
  • edit: false (hoặc hàm trả false) để ẩn nút sửa, ví dụ khi đơn đã chốt.

Trả về

Một trang có PageContainer. Nút chuyển trạng thái hỏi lại trước các bước rủi ro, rồi tải lại trang. Form sửa dựng từ columns, bỏ cột trạng thái: trạng thái chỉ đổi qua move. Xoá xong quay về path. Lỗi API hiện câu báo của server.

Ví dụ

Tab lịch sử dùng ActivityLog của manh/shell, ghi cuộc gọi và ghi chú ngay trên trang:

app/deals/[id:int]/page.tsx
<ResourceDetail api={api.deals} path="/deals" listTitle="Cơ hội" columns={dealColumns} title={(d) => d.title} status="stage" statusEnum={DealStage} flow={DealFlow} move={(to, d, v) => api.deals.stage(d.id, { to, ...v })} tabs={[{ key: "log", tab: "Lịch sử", render: (d, reload) => <DealLog id={d.id} onDone={reload} /> }]} />

Server vẫn chặn bước sai bằng Flow.assert; nút chỉ là giao diện, xem defineFlow.

Bước tiếp theo

Cập nhật