submit
Hàm cho onFinish của ProForm, ModalForm và DrawerForm: gọi API, báo đã xong, tải lại bảng, đưa lỗi của server về đúng ô nhập và trả true hoặc false.
Cách dùng
app/orders/page.tsx
import { useRef } from "react";
import { ModalForm, ProForm, ProFormText, ProFormDigit, ProTable, type ActionType } from "@ant-design/pro-components";
import { Button } from "antd";
import { useApiClient } from "app/api";
import { submit, tableRequest } from "app/hooks";
export default function OrdersPage() {
const api = useApiClient();
const ref = useRef<ActionType>();
const [form] = ProForm.useForm();
const create = (
<ModalForm title="Thêm đơn" form={form} trigger={<Button type="primary">Thêm đơn</Button>}
onFinish={submit((v) => api.orders.create(v), { done: "Đã tạo đơn", reload: ref, form })}>
<ProFormText name="customerName" label="Khách hàng" rules={[{ required: true }]} />
<ProFormDigit name="total" label="Tổng tiền" min={0} />
</ModalForm>
);
return <ProTable rowKey="id" actionRef={ref} request={tableRequest(api.orders.list)} toolBarRender={() => [create]} />;
}Chữ ký
app/hooks.ts
function submit<V>(
run: (values: V) => Promise<any>,
o?: { done?: string; reload?: { current?: { reload?: () => void } | null }; form?: any },
): (values: V) => Promise<boolean>;Tham số
run: hàm nhận giá trị của form và gọi API, ví dụ(v) => api.orders.update(row.id, v).o.done: chữ báo khi thành công, ví dụ “Đã lưu”. Bỏ trống thì không báo.o.reload:actionRefcủaProTablecần tải lại sau khi thành công.o.form: instance của form, lấy từProForm.useForm(), cũng truyền vào propformcủa chính form đó. Có nó thì lỗi theo từng trường của server hiện ngay dưới ô nhập tương ứng.
Trả về
Một hàm đưa thẳng vào onFinish. Khi run thành công, hàm báo done, tải lại bảng và trả true, nên form đóng lại. Khi lỗi, hàm trả false và form vẫn mở:
- API trả 400 hoặc 422 kèm
fieldsvà cóo.form: mỗi lỗi hiện dưới ô của trường đó. - Lỗi khác: hiện câu báo của server, hoặc “Có lỗi xảy ra, vui lòng thử lại” khi server không gửi câu nào.
submit không ném lỗi và không hiện lỗi hai lần khi khung AppShell đã hiện.
Ví dụ
Form sửa trong một dòng của bảng:
app/orders/page.tsx
<ModalForm title="Sửa đơn" initialValues={row} trigger={<a>Sửa</a>}
onFinish={submit((v) => api.orders.update(row.id, v), { done: "Đã lưu", reload: ref })}>
<ProFormText name="customerName" label="Khách hàng" />
</ModalForm>Lỗi validation 400 của handler đã có fields với câu lỗi tiếng Việt, xem Mã lỗi. Không tự viết try { … } catch { message.error(…) } quanh form.
Bước tiếp theo
- useAction: nút và form không phải tạo hay sửa.
- tableRequest: bảng mà
reloadtải lại. - optionsFrom: ô chọn trong form lấy lựa chọn từ API.
Cập nhật