optionsFrom
Biến một API danh sách thành lựa chọn cho Select hay ProFormSelect, có tìm theo chữ người dùng gõ. Dùng cho ô chọn khách hàng, nhân viên, sản phẩm.
Cách dùng
app/tickets/new/page.tsx
import { ProForm, ProFormSelect } from "@ant-design/pro-components";
import { useApiClient } from "app/api";
import { optionsFrom, submit } from "app/hooks";
export default function NewTicketPage() {
const api = useApiClient();
return (
<ProForm onFinish={submit((v) => api.tickets.create(v), { done: "Đã nhận máy" })}>
<ProFormSelect name="customerId" label="Khách hàng" showSearch
request={optionsFrom(api.customers.list, "name")} />
<ProFormSelect name="technicianId" label="Kỹ thuật viên"
request={optionsFrom(api.users.members, (u) => `${u.name} (${u.role})`)} />
</ProForm>
);
}Chữ ký
app/hooks.ts
function optionsFrom(
list: (q?: any) => Promise<any>,
label?: string | ((r: any) => string),
value?: string,
): (params?: { keyWords?: string; [k: string]: any }) => Promise<Array<{ label: string; value: any }>>;Tham số
list: hàm danh sách của useApiClient, ví dụapi.customers.listhayapi.users.members.label: tên trường làm nhãn, mặc định"name"; hoặc một hàm nhận cả dòng và trả nhãn.value: tên trường làm giá trị, mặc định"id".
Trả về
Một hàm đúng dạng request của ProFormSelect. Mỗi lần chạy, hàm gọi list với pageSize: 50; khi ô có showSearch, chữ người dùng gõ được gửi dưới tên search. Kết quả dạng mảng hay { data, total } đều được, và trả về [{ label, value }].
Ví dụ
Ô tìm khách theo tên hoặc số điện thoại: khai báo các cột tìm ở server bằng listOf(customers, query, { search: [customers.name, customers.phone] }), rồi bật showSearch ở ô chọn như trên.
- Chỉ 50 dòng đầu được tải. Danh sách dài thì luôn bật
showSearch. api.users.members()trả mảng người dùng đang hoạt động, mọi người đã đăng nhập đều gọi được; hợp cho ô chọn người phụ trách.
Bước tiếp theo
- submit: gửi form có ô chọn này.
- listSchema, listOf: khai báo cột tìm ở server.
- Form: các mẫu form thường gặp.
Cập nhật