Formations — 1 037 leçons en français

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 imports d'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 (ou FormGroup/FormArray imbriqué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'un FormGroup : fb.group({...}) plutôt qu'un empilement de new FormControl(...).

NonNullableFormBuilder

Variante de FormBuilder, accessible via fb.nonNullable, qui type les contrôles comme non-nullables : reset() revient à la valeur initiale au lieu de null.

valueChanges

Observable exposé par un FormControl ou un FormGroup, 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 un FormGroup TypeScript à une balise <form>, formControlName associe un contrôle enfant à son nom dans le groupe.

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.