React Academy · Leçon

Premiers pas avec React Hook Form

Installez RHF, appelez useForm, enregistrez les champs de saisie et gérez l’envoi du formulaire.

Premiers pas avec React Hook Form est une leçon React Academy gratuite sur CoddyKit. Ceci est la leçon 1 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 installerez React Hook Form, appellerez useForm, enregistrerez les champs et gérerez les envois de formulaires sans administrer individuellement les variables d’état.

Pourquoi React Hook Form ?

Les formulaires contrôlés traditionnels dans React nécessitent un useState par champ et un onChange par champ de saisie. React Hook Form (RHF) gère tout cela en interne à l’aide de champs non contrôlés, ce qui vous offre une API plus simple avec moins de nouveaux rendus.

Installation

Installez le paquet. Aucune dépendance entre pairs supplémentaire n’est nécessaire pour une utilisation de base.

npm install react-hook-form

Crochet useForm

Appelez useForm() pour obtenir la fonction register, l’enveloppe handleSubmit et formState. Ce sont les trois éléments fondamentaux nécessaires à tout formulaire.

import { useForm } from 'react-hook-form';

function LoginForm() {
  const { register, handleSubmit, formState: { errors } } = useForm();
  const onSubmit = data => console.log(data);
  return (
    <form onSubmit={handleSubmit(onSubmit)}>
      ...
    </form>
  );
}

Enregistrer les champs

Étendez le résultat de register('fieldName') sur chaque champ de saisie. RHF attache une référence et des gestionnaires d’événements au champ en interne : aucune valeur ni aucun onChange n’est nécessaire.

<input {...register('email')} type="email" />
<input {...register('password')} type="password" />
<button type="submit">Log in</button>

La fonction de rappel onSubmit

handleSubmit valide tous les champs et appelle votre fonction de rappel onSubmit avec un objet de données typé uniquement lorsque le formulaire est valide. Si la validation échoue, il renseigne plutôt formState.errors.

const onSubmit = (data) => {
  // data = { email: 'a@b.com', password: 'secret' }
  loginUser(data);
};

Valeurs par défaut

Transmettez `defaultValues` à useForm pour préremplir les champs du formulaire. Cette possibilité est utile pour les formulaires de modification dans lesquels vous chargez des données existantes.

const { register } = useForm({
  defaultValues: { email: user.email, name: user.name },
});

Propriétés de formState

formState expose des valeurs booléennes utiles : `isSubmitting` (vrai pendant l’exécution de handleSubmit), `isDirty` (vrai si un champ a changé), `isValid` (vrai en l’absence d’erreurs) et l’objet `errors`.

const { formState: { isSubmitting, isDirty, isValid, errors } } = useForm();

Réinitialiser le formulaire

Appelez `reset()` pour effacer tous les champs et réinitialiser formState. Vous pouvez également transmettre de nouvelles valeurs par défaut.

const { reset } = useForm();

const onSubmit = async (data) => {
  await saveData(data);
  reset(); // clear after submit
};

Avantage en matière de performances

Comme RHF utilise des champs non contrôlés, le formulaire n’est pas réaffiché à chaque frappe, contrairement aux formulaires React contrôlés. Seules les erreurs de validation et l’état de l’envoi provoquent de nouveaux rendus, ce qui rend les grands formulaires réactifs.

Vérification rapide

Que fait l’appel à handleSubmit(onSubmit) lorsque l’utilisateur envoie le formulaire ?

Récapitulatif

Installez RHF, appelez useForm pour obtenir register et handleSubmit, étendez register() sur les champs et enveloppez votre gestionnaire d’envoi avec handleSubmit. Définissez defaultValues pour les formulaires de modification et appelez reset() après un envoi réussi.

À suivre

Prochaine leçon : **Règles de validation et messages d’erreur** — vous appliquerez les règles de validation intégrées et afficherez des messages d’erreur aux utilisateurs.

Questions Fréquemment Posées

La leçon « Premiers pas avec React Hook Form » est-elle gratuite ?

Oui — le texte complet de « Premiers pas avec React Hook Form » 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 « Premiers pas avec React Hook Form » ?

Installez RHF, appelez useForm, enregistrez les champs de saisie et gérez l’envoi du formulaire. 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 1 sur 4.

Combien de temps prend la leçon « Premiers pas avec React Hook Form » ?

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

Premiers pas avec React Hook Form
Règles de validation et messages d’erreur
Validation de schéma avec Zod
Champs dynamiques avec useFieldArray

← Retour à React Academy