Skip to Content

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: actionRef của ProTable cầ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 prop form củ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 fields và 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à reload tải lại.
  • optionsFrom: ô chọn trong form lấy lựa chọn từ API.
Cập nhật