La boite à outils des "Reactive Forms"

FormControl

La classe FormControl est une indirection permettant de contrôler et d'accéder à l'état des "controls" de la vue (e.g. <input>).

export class BookFormComponent {

    bookTitleControl = new FormControl();
    bookDescriptionControl = new FormControl();

    submitBook() {
        console.log(this.bookTitleControl.value);
        console.log(this.bookDescriptionControl.value);
    }

}
<input
    type="text"
    [formControl]="bookTitleControl">

<textarea [formControl]="bookDescriptionControl"></textarea>

<button
    type="submit"
    (click)="submitBook()">SUBMIT</button>

FormControl fournit différentes propriétés et méthodes permettant de piloter le "control" :

  • value : permet d'accéder à la valeur actuellement contenu dans le "control".

  • valueChanges : est un Observable permettant d'observer les changements de valeur du "control".

  • reset, setValue et patchValue permettent de modifier l'état et la valeur du "control".

FormGroup

FormGroup permet de regrouper des "controls" afin de faciliter l'implémentation, récupérer la valeur groupée des "controls" ou encore appliquer des validateurs au groupe.

Le FormGroup est construit avec un "plain object" associant chaque propriété à un FormControl . Il est alors possible d'accéder aux valeurs et aux "controls" via la propriété associée.

export class BookFormComponent {

    bookForm = new FormGroup({
        title: new FormControl(),
        description: new FormControl()
    });

    submitBook() {
        console.log(this.bookForm.value);
    }

}
<input
        type="text"
        [formControl]="bookForm.controls.title">

<textarea [formControl]="bookForm.controls.description"></textarea>

<button
        type="submit"
        (click)="submitBook()">SUBMIT</button>

L'objet this.bookForm.value présente l'ensemble des valeurs des controls via un "plain objet" : {title: 'TITLE', description: null}

La classe FormGroup propose de nombreuses propriétés et méthodes similaires à celles rencontrées précédemment avec FormControl. En effet, FormControl et FormGroup héritent de la classe abstraite AbstractControl.

Un FormGroup est donc également un "control" et il est donc possible de construire une arborescence de FormGroups afin de regrouper différentes parties d'un formulaire de taille importante ou dont des parties sont réutilisables dans d'autres contextes.

new FormGroup({
    address: new FormGroup({
        street: new FormControl()
    })
});

FormArray

FormArray héritant également de la classe abstraite AbstractControl, permet de créer un "control" contenant une liste de "controls" (e.g. FormControl ou FormGroup) ordonnés (contrairement à FormGroup qui permet de créer un groupe de "controls" accessibles avec des clés sur un "plain object").

La valeur contenu dans le FormArray est de type Array.

FormBuilder

Le module ReactiveFormsModule implémente également un service FormBuilder qui permet d'ajouter un peu de "syntactic sugar" afin de simplifier la création des FormGroup, FormArray ou FormControl.

bookForm: FormGroup;

constructor(private _formBuilder: FormBuilder) {
    this.bookForm = this._formBuilder.group({
        title: null,
        description: null
    });
}

Dernière mise à jour