0Pricing
React Academy · Leçon

Validation de schéma avec Zod

Intégrez @hookform/resolvers et les schémas Zod pour une validation de formulaire sûre du point de vue des types.

Validation de schéma avec Zod est une leçon React Academy gratuite sur CoddyKit. Ceci est la leçon 3 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage React Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours React Academy comprend 4 leçons au total.

Bienvenue

Dans cette leçon, vous intégrerez React Hook Form à des schémas Zod via @hookform/resolvers afin d’obtenir une validation sûre du point de vue des types, avec une source de vérité unique pour le formulaire et les types TypeScript.

Pourquoi utiliser la validation par schéma ?

Définir les règles de validation directement dans register() devient verbeux et difficile à réutiliser. Un schéma Zod définit ALL la validation au même endroit, déduit automatiquement les types TypeScript et peut être partagé entre le frontend et le backend.

Installation

Installez Zod et le paquet de résolution RHF.
npm install zod @hookform/resolvers

Définir un schéma Zod

Utilisez z.object() pour définir la structure de votre formulaire. Chaque champ utilise un type Zod auquel sont enchaînées des méthodes de validation.
import { z } from 'zod';

const loginSchema = z.object({
  email: z.string().email('Invalid email'),
  password: z.string().min(8, 'At least 8 characters'),
});

Déduire les types TypeScript

Utilisez z.infer pour déduire automatiquement le type TypeScript à partir de votre schéma Zod. Aucune interface distincte n’est nécessaire.
type LoginForm = z.infer<typeof loginSchema>;
// { email: string; password: string }

Connecter useForm via resolver

Transmettez zodResolver(schema) à l’option resolver de useForm. RHF utilisera Zod pour valider le formulaire au lieu de règles intégrées directement dans les champs.
import { zodResolver } from '@hookform/resolvers/zod';

const { register, handleSubmit, formState } = useForm<LoginForm>({
  resolver: zodResolver(loginSchema),
});

Fini les règles intégrées directement dans les champs

Avec zodResolver, vous n’avez plus besoin de transmettre des règles à register(). Appelez simplement register('fieldName') sans deuxième argument. Zod gère toute la validation.
<input {...register('email')} />
{errors.email && <p>{errors.email.message}</p>}

Validations complexes avec Zod

Zod prend en charge des validations puissantes : url(), les identifiants UUID, les expressions régulières, refine() pour une logique personnalisée et superRefine() pour valider plusieurs champs ensemble.
const schema = z.object({
  url: z.string().url('Must be a valid URL'),
  confirmPassword: z.string(),
}).refine(
  data => data.password === data.confirmPassword,
  { message: 'Passwords must match', path: ['confirmPassword'] }
);

Validation entre plusieurs champs

refine() ou superRefine() de Zod peut accéder à toutes les valeurs des champs, ce qui permet de définir des règles entre plusieurs champs, comme « la date de fin doit être postérieure à la date de début ».
const schema = z.object({
  start: z.string(),
  end: z.string(),
}).refine(d => d.end > d.start, {
  message: 'End must be after start',
  path: ['end'],
});

Partage des schémas avec le serveur

Dans un projet TypeScript couvrant le frontend et le backend, exportez le schema depuis un module partagé. Utilisez-le à la fois dans le formulaire React AND dans votre gestionnaire d'API Node.js/Next.js afin d'obtenir une validation cohérente.
// shared/schemas.ts
export const loginSchema = z.object({ ... });

// frontend — import and use as resolver
// backend — import and call .parse() on request body

Vérification rapide

Quel est le principal avantage de l'utilisation de z.infer comme type du formulaire en TypeScript ?

Récapitulatif

Définissez un schema Zod, déduisez le type TypeScript avec z.infer, transmettez zodResolver à useForm et supprimez les règles de validation intégrées au formulaire. Utilisez refine() pour valider plusieurs champs ensemble et partagez les schémas entre le frontend et le backend.

À suivre

Leçon suivante : **Champs dynamiques avec useFieldArray** — vous ajouterez, supprimerez et réorganiserez des champs de formulaire dynamiques à l'aide du crochet useFieldArray.

Questions Fréquemment Posées

La leçon « Validation de schéma avec Zod » est-elle gratuite ?

Oui — le texte complet de « Validation de schéma avec Zod » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours React Academy, passe à CoddyKit PRO. Le cours React Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Validation de schéma avec Zod » ?

Intégrez @hookform/resolvers et les schémas Zod pour une validation de formulaire sûre du point de vue des types. Tu pratiques React Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer React Academy ?

Aucune expérience préalable n'est requise. React Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 3 sur 4.

Combien de temps prend la leçon « Validation de schéma avec Zod » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon React Academy ?

Oui. Chaque leçon React Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Premiers pas avec React Hook Form
  2. Règles de validation et messages d’erreur
  3. Validation de schéma avec Zod
  4. Champs dynamiques avec useFieldArray
← Retour à React Academy