React từ cơ bản đến nâng cao
Trang chủ / Module 13
📝 Module 13 / 22 · 5 ngày 📅 Tuần 7 ●●●○ Khó

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.

React Hook FormZoduseActionStateuseOptimistic
📌 Vì sao module này quan trọng

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, useFormStatus củ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ốngGợ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, wizardReact Hook Form + Zod (vẫn có thể submit vào Server Action)
SPA thuần gọi RESTRHF + 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

Form đặt hàng 3 bước

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

✅ 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