Form và kiểm tra dữ liệu
Form dùng React Hook Form để quản lý trạng thái nhập liệu, Zod để mô tả quy tắc kiểm tra, và cầu nối @hookform/resolvers để hai bên làm việc cùng nhau. Thông báo lỗi được dịch theo ngôn ngữ hiện tại. Trang này giải thích cách các mảnh ghép nối, dùng form đăng nhập làm ví dụ.
Công nghệ
| Gói | Khai báo | Đang cài |
|---|---|---|
react-hook-form | ^7.53.0 | 7.65.0 |
zod | ^4.0.16 | 4.0.16 |
@hookform/resolvers | ^5.2.1 | 5.2.1 |
Cách ghép với nhau
- Schema Zod nằm ở
src/features/<miền>/schemas/<miền>.schema.ts. Kiểu TypeScript của dữ liệu form sinh từ schema bằngz.infer, nên quy tắc và kiểu không lệch nhau. - Hàm tạo schema nhận bộ dịch. Ví dụ
createLoginSchema(t)nhận hàmtvà dùng khóa nhưauthModal.validation.email.requiredlàm thông báo lỗi. Nhờ đó thông báo hiện đúng ngôn ngữ đang chọn. - Form dựng schema bằng
useMemorồi truyền chozodResolver:
const loginSchema = useMemo(() => createLoginSchema(t), [t]);
const form = useForm<LoginFormData>({ resolver: zodResolver(loginSchema) });- Schema mặc định (
LoginSchema,RegisterSchema) được tạo sẵn với bộ dịch trả lại chính khóa, không dịch gì. - Thành phần
Formcủa shadcn/ui trongsrc/components/ui/form.tsxbọcFormProvidercủa React Hook Form cùngFormField,FormItem,FormLabel,FormControl,FormMessage. Chúng gắn nhãn, ô nhập và thông báo lỗi với nhau.
Cùng file schema còn khai báo cấu trúc phản hồi đăng nhập (LoginResponseSchema); tại thời điểm viết, không có nơi nào ngoài file này import nó. Các schema đăng nhập, đăng ký có test ở auth.schema.test.ts.
Quy tắc kiểm tra mẫu (form đăng nhập)
Email được cắt khoảng trắng, đưa về chữ thường, kiểm tra định dạng, độ dài tối đa 255 ký tự, không chứa khoảng trắng và không có ký tự lạ ở phần trước @. Mật khẩu ở form đăng nhập chỉ yêu cầu không để trống; các quy tắc mật khẩu mạnh (chữ hoa, chữ thường, chữ số, ký tự đặc biệt) được khai báo bằng biểu thức chính quy trong cùng file schema và áp dụng cho form đăng ký cùng một số form mật khẩu khác.
Lý do chọn
Chưa có ghi chép về lý do chọn bộ ba này. Xem Các quyết định công nghệ.
Source code liên quan
src/features/auth/schemas/auth.schema.ts: schema Zod có bộ dịchsrc/features/auth/schemas/auth.schema.test.ts: test của schemasrc/components/modals/login-form.tsx: form dùngzodResolversrc/components/ui/form.tsx: thành phầnFormcủa shadcn/uisrc/contexts/i18n-provider.tsx: nguồn của hàmt
