Form nâng cao: React Hook Form, Zod và React 19 Actions
Form lớn hiệu năng cao với React Hook Form + Zod, form nhiều bước, field động, và API mới của React 19: form action, useActionState, useFormStatus, useOptimistic.
Form là nơi có nhiều bug nghiệp vụ nhất: validate lệch giữa client và server, submit hai lần, mất dữ liệu khi lỗi mạng, chậm khi có 50 field. React 19 đưa form action vào lõi React, thay đổi cách viết form — cần biết cả cách cũ lẫn cách mới.
🎯 Mục tiêu học tập
- Xây form với React Hook Form + Zod, dùng chung schema với backend
- Xử lý field động (
useFieldArray) và form nhiều bước - Dùng
action,useActionState,useFormStatuscủa React 19 - Làm optimistic UI bằng
useOptimistic - Hiển thị lỗi từ server đúng field
React Hook Form + Zod
import { useForm } from 'react-hook-form';
import { zodResolver } from '@hookform/resolvers/zod';
import { z } from 'zod';
export const SignupSchema = z.object({
email: z.email('Email không hợp lệ'),
password: z.string().min(8, 'Tối thiểu 8 ký tự'),
confirm: z.string(),
age: z.coerce.number().int().min(16, 'Phải từ 16 tuổi'),
}).refine(d => d.password === d.confirm, { path: ['confirm'], message: 'Mật khẩu không khớp' });
type SignupInput = z.infer<typeof SignupSchema>;
function SignupForm() {
const { register, handleSubmit, setError, formState: { errors, isSubmitting } } =
useForm<SignupInput>({ resolver: zodResolver(SignupSchema), mode: 'onBlur' });
const onSubmit = async (data: SignupInput) => {
const res = await api.signup(data);
if (res.fieldErrors?.email) setError('email', { message: res.fieldErrors.email }); // lỗi từ server
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
<input {...register('email')} aria-invalid={!!errors.email} />
{errors.email && <p role="alert">{errors.email.message}</p>}
<input type="password" {...register('password')} />
<input type="password" {...register('confirm')} />
{errors.confirm && <p role="alert">{errors.confirm.message}</p>}
<input {...register('age')} inputMode="numeric" />
<button disabled={isSubmitting}>{isSubmitting ? 'Đang gửi…' : 'Đăng ký'}</button>
</form>
);
}
RHF dùng input uncontrolled + ref nên gõ phím không render lại cả form. Dùng Controller cho component bên thứ ba
(date picker, select tuỳ biến). Schema Zod đặt ở package chung để backend validate bằng đúng schema đó — client validate
là cho trải nghiệm, server validate mới là bảo vệ.
Field động và form nhiều bước
const { control, register } = useForm<{ items: { name: string; qty: number }[] }>({ defaultValues: { items: [{ name: '', qty: 1 }] } });
const { fields, append, remove } = useFieldArray({ control, name: 'items' });
{fields.map((f, i) => (
<div key={f.id}> {/* f.id do RHF tạo, đừng dùng index */}
<input {...register(`items.${i}.name`)} />
<input type="number" {...register(`items.${i}.qty`, { valueAsNumber: true })} />
<button type="button" onClick={() => remove(i)}>Xoá</button>
</div>
))}
<button type="button" onClick={() => append({ name: '', qty: 1 })}>Thêm dòng</button>
Form nhiều bước: một useForm chung cho toàn bộ, mỗi bước gọi trigger(['field1','field2']) để validate riêng phần
của bước đó trước khi sang bước sau; lưu nháp vào sessionStorage để reload không mất.
React 19: form action và useActionState
React 19 cho phép truyền hàm (có thể async) vào action của <form>. React tự quản lý trạng thái pending,
tự reset form uncontrolled khi thành công, và chạy trong transition.
import { useActionState } from 'react';
import { useFormStatus } from 'react-dom';
type State = { error?: string; ok?: boolean };
async function updateName(prev: State, formData: FormData): Promise<State> {
const name = String(formData.get('name') ?? '').trim();
if (name.length < 2) return { error: 'Tên quá ngắn' };
try { await api.updateName(name); return { ok: true }; }
catch { return { error: 'Lỗi mạng, thử lại' }; }
}
function SubmitButton() {
const { pending } = useFormStatus(); // đọc trạng thái của <form> cha gần nhất
return <button disabled={pending}>{pending ? 'Đang lưu…' : 'Lưu'}</button>;
}
export function NameForm() {
const [state, formAction, isPending] = useActionState(updateName, {});
return (
<form action={formAction}>
<input name="name" />
<SubmitButton />
{state.error && <p role="alert">{state.error}</p>}
{state.ok && <p>Đã lưu ✅</p>}
</form>
);
}
Trong Next.js, hàm action này có thể là Server Action ('use server') — form chạy được cả khi JS chưa
tải xong (progressive enhancement). Xem khoá Next.js Module 7.
useOptimistic
function Thread({ messages, sendMessage }: { messages: Msg[]; sendMessage: (fd: FormData) => Promise<void> }) {
const [optimistic, addOptimistic] = useOptimistic(
messages,
(state, text: string) => [...state, { id: 'temp-' + Date.now(), text, sending: true }],
);
async function action(fd: FormData) {
addOptimistic(String(fd.get('text'))); // hiện ngay
await sendMessage(fd); // xong thì messages (prop) cập nhật, bản tạm biến mất
}
return (
<>
{optimistic.map(m => <p key={m.id} style={{ opacity: m.sending ? 0.5 : 1 }}>{m.text}</p>)}
<form action={action}><input name="text" /><button>Gửi</button></form>
</>
);
}
Nếu action lỗi, giá trị optimistic tự bị bỏ khi transition kết thúc — bạn chỉ cần hiển thị lỗi.
Chọn công cụ nào
| Tình huống | Gợi ý |
|---|---|
| Form đơn giản, 1-5 field, có Server Action (Next.js) | <form action> + useActionState + Zod ở server |
| Form lớn, validate phức tạp ở client, field động, wizard | React Hook Form + Zod (vẫn có thể submit vào Server Action) |
| SPA thuần gọi REST | RHF + useMutation của TanStack Query |
🚩 Sai lầm hay gặp
- Chỉ validate ở client.
- Không chặn submit hai lần (nút không disabled khi pending) → tạo hai đơn hàng. Backend nên có idempotency key.
- Hiển thị lỗi chỉ bằng màu đỏ, không có text và
aria-invalid→ người dùng screen reader không biết.
🏋️ Bài tập thực hành
Bước 1 thông tin khách, bước 2 danh sách sản phẩm (field động, tính tổng realtime), bước 3 xác nhận. Validate từng bước, lưu nháp, hiển thị lỗi server theo field. Làm thêm một form 'đổi tên' bằng useActionState để so sánh hai cách.
📚 Tài nguyên học tập
-
React Hook FormTài liệuDocs
-
react.dev — useActionStateAPI React 19Docs
-
react.dev — useOptimisticAPI React 19Docs
✅ Tự đánh giá hoàn thành
- Tôi dựng được form RHF + Zod với lỗi từ server
- Tôi dùng được
useFieldArray - Tôi giải thích được form action,
useActionState,useFormStatus - Tôi làm được optimistic UI bằng
useOptimistic