Formations — 1 037 leçons en français

Accueil › React › Les actions de formulaire

Les actions de formulaire

Les formulairesdebutant

Depuis React 19, l'attribut action d'un <form> accepte une fonction.

function Inscription() {
  async function creer(formData) {
    await fetch("/api/inscriptions", {
      method: "POST",
      body: JSON.stringify({ email: formData.get("email") }),
      headers: { "Content-Type": "application/json" },
    });
  }

  return (
    <form action={creer}>
      <input name="email" type="email" required />
      <button type="submit">S'inscrire</button>
    </form>
  );
}

Il n'y a ni useState, ni onChange, ni preventDefault : React l'appelle pour vous, passe un FormData construit depuis les attributs name, et réinitialise les champs non contrôlés quand l'action a réussi.

L'état de retour et l'état d'envoi

function creer(etatPrecedent, formData) {
  const email = formData.get("email");
  if (!email.includes("@")) return { erreur: "Email invalide" };
  return { message: "Inscription enregistrée" };
}

function Inscription() {
  const [etat, action, enAttente] = useActionState(creer, {});

  return (
    <form action={action}>
      <input name="email" />
      {etat.erreur && <p role="alert">{etat.erreur}</p>}
      <button disabled={enAttente}>{enAttente ? "Envoi…" : "S'inscrire"}</button>
    </form>
  );
}

useActionState enveloppe l'action : elle reçoit l'état précédent avant le FormData, et ce qu'elle renvoie devient le nouvel état. Le drapeau d'attente est fourni, donc le verrou de la leçon précédente n'est plus à écrire.

Un formulaire contrôlé classique reste parfaitement valable. Ces API retirent de l'état à tenir ; elles ne rendent pas l'autre approche obsolète.

Les termes à connaître

Action de formulaire

Une fonction passée à l'attribut action d'un <form>. React l'appelle à la soumission avec un FormData, et appelle preventDefault à votre place.

`FormData`

L'objet du navigateur qui rassemble les champs du formulaire par leur attribut name. On y lit avec formData.get("nom") ; un champ sans name en est absent.

`useActionState`

Un hook qui rend [etat, action, enAttente]. L'action qu'il enveloppe reçoit l'état précédent et le FormData, et ce qu'elle renvoie devient le nouvel état.

`useFormStatus`

Un hook qui donne l'état d'envoi du formulaire parent — pending, data, method, action. Il doit être appelé dans un composant rendu à l'intérieur du <form>.

Réinitialisation automatique

Après une action réussie, React remet à zéro les champs non contrôlés du formulaire. Un champ contrôlé garde sa valeur : c'est l'état React qui la détient.

Action serveur

Une action marquée "use server", exécutée sur le serveur. Elle demande un cadre applicatif qui la prenne en charge ; les actions de formulaire, elles, fonctionnent sans.

Qui détient la valeur

La question à trancher avant d'écrire le formulaire. Soit l'état React (value + onChange), soit le DOM lu par FormData. Les deux à la fois est la source de confusion.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.