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
actiond'un<form>. React l'appelle à la soumission avec unFormData, et appellepreventDefaultà votre place.- `FormData`
L'objet du navigateur qui rassemble les champs du formulaire par leur attribut
name. On y lit avecformData.get("nom"); un champ sansnameen est absent.- `useActionState`
Un hook qui rend
[etat, action, enAttente]. L'action qu'il enveloppe reçoit l'état précédent et leFormData, 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 parFormData. Les deux à la fois est la source de confusion.
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.