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
FormArraypour 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
FormArrayde commande contient typiquement desFormGroup(une ligne = unFormGroupavecproduit,quantite…), eux-mêmes composés deFormControl. 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 dansgetRawValue().- @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.
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.