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ầndetail; cóupdatethì có nút Sửa, córemovevàremove={true}thì có nút Xoá.id: id bản ghi; mặc định lấyidtrê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.flowcó 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ủamove.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
- defineFlow: khai báo bước nào vai nào được làm.
- ResourceList: trang danh sách dẫn tới trang này.
- Trang chi tiết: bố cục trang một bản ghi khi cần tự viết.
Cập nhật