Accueil › Angular › Les formulaires réactifs
Les formulaires réactifs
Les formulairesdebutant
Un formulaire réactif décrit le formulaire entièrement en TypeScript : un FormGroup regroupe des FormControl, et le template ne fait que s'y lier. C'est l'approche recommandée pour un formulaire avec de la validation ou une structure qui évolue dynamiquement.
Il faut d'abord ajouter ReactiveFormsModule aux imports du composant, puis construire le groupe avec FormBuilder :
import { Component, inject } from '@angular/core';
import { FormBuilder, ReactiveFormsModule, Validators } from '@angular/forms';
@Component({
selector: 'app-inscription',
imports: [ReactiveFormsModule],
templateUrl: './inscription.html',
})
export class Inscription {
private fb = inject(FormBuilder);
inscriptionForm = this.fb.group({
email: ['', [Validators.required, Validators.email]],
motDePasse: ['', Validators.required],
});
soumettre() {
console.log(this.inscriptionForm.value);
}
}
Dans le template, [formGroup] lie le groupe au <form>, et formControlName lie chaque champ par son nom :
<form [formGroup]="inscriptionForm" (ngSubmit)="soumettre()">
<input type="email" formControlName="email" />
<input type="password" formControlName="motDePasse" />
<button type="submit">S'inscrire</button>
</form>
FormBuilder type automatiquement le groupe d'après les valeurs initiales fournies : inscriptionForm.value.email est bien typé string. Chaque FormControl expose sa value, sa validité (valid/invalid) et un flux valueChanges pour réagir en direct.
Les termes à connaître
- ReactiveFormsModule
Module à ajouter au tableau
importsd'un composant standalone pour utiliser les formulaires réactifs (FormGroup,FormControl) et les directives de template[formGroup]/formControlName.- FormControl
Représente un champ du formulaire : sa valeur, sa validité et son état (
touched,dirty…). C'est la brique de base de tout formulaire réactif.- FormGroup
Regroupe plusieurs
FormControl(ouFormGroup/FormArrayimbriqués) sous un seul objet. Sa valeur est un objet, et sa validité est l'agrégat de celle de ses contrôles.- FormBuilder
Service injectable (
inject(FormBuilder)) qui simplifie l'écriture d'unFormGroup:fb.group({...})plutôt qu'un empilement denew FormControl(...).- NonNullableFormBuilder
Variante de
FormBuilder, accessible viafb.nonNullable, qui type les contrôles comme non-nullables :reset()revient à la valeur initiale au lieu denull.- valueChanges
Observableexposé par unFormControlou unFormGroup, qui émet à chaque changement de valeur. S'utilise avec les opérateurs RxJS habituels (debounceTime,distinctUntilChanged…).- formGroup / formControlName
Directives de liaison au template :
[formGroup]associe unFormGroupTypeScript à une balise<form>,formControlNameassocie un contrôle enfant à son nom dans le groupe.
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.