Formations — 1 037 leçons en français

Accueil › Angular › Formulaires dynamiques avec FormArray

Formulaires dynamiques avec FormArray

Les formulairesdebutant

Un FormArray regroupe une liste de contrôles de même forme, quand leur nombre n'est pas fixé à l'avance — typiquement les lignes d'une commande :

commandeForm = this.fb.group({
  lignes: this.fb.array([
    this.fb.group({ produit: ['', Validators.required], quantite: [1, Validators.min(1)] }),
  ]),
});

get lignes() {
  return this.commandeForm.controls.lignes;
}

ajouterLigne() {
  this.lignes.push(this.fb.group({ produit: ['', Validators.required], quantite: [1, Validators.min(1)] }));
}

supprimerLigne(index: number) {
  this.lignes.removeAt(index);
}

Dans le template, on itère sur lignes.controls avec @for, et formGroupName="$index" relie chaque bloc à sa ligne :

<div [formGroup]="commandeForm">
  <div formArrayName="lignes">
    @for (ligne of lignes.controls; track ligne) {
      <div [formGroupName]="$index">
        <input formControlName="produit" placeholder="Produit" />
        <input type="number" formControlName="quantite" />
        <button type="button" (click)="supprimerLigne($index)">Retirer</button>
      </div>
    }
  </div>
  <button type="button" (click)="ajouterLigne()">Ajouter une ligne</button>
</div>

Comme un FormGroup, un FormArray est invalid dès qu'un seul de ses éléments l'est, et sa value est un tableau des valeurs de chaque contrôle.

Les termes à connaître

FormArray

Contrôle qui regroupe une liste de contrôles (ou de groupes) de même forme, indexés numériquement. Utile quand le nombre de champs n'est pas connu à l'avance, ex. les lignes d'une commande.

push / removeAt

Méthodes de FormArray pour ajouter un contrôle à la fin (push) ou retirer le contrôle à l'index donné (removeAt). Modifient la liste en place et recalculent la validité du tableau.

Groupe imbriqué

Un FormArray de commande contient typiquement des FormGroup (une ligne = un FormGroup avec produit, quantite…), eux-mêmes composés de FormControl. Les formulaires réactifs s'imbriquent sans limite de profondeur.

updateValueAndValidity

Recalcule la valeur et la validité d'un contrôle (et par défaut de ses parents). Nécessaire après avoir changé des validateurs dynamiquement avec setValidators/clearValidators, qui ne déclenchent pas ce recalcul tout seuls.

enable / disable

Méthodes qui activent ou désactivent un contrôle. Un contrôle désactivé est exclu de la validation du parent et de value, mais reste présent dans getRawValue().

@for sur les contrôles

Boucle de template pour afficher chaque contrôle d'un FormArray : @for (ligne of lignesCommande.controls; track ligne), avec [formGroupName]="$index" pour lier chaque ligne.

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.