Template-driven Forms 🤢

L'approche "Template-driven Forms" nécessite de mettre la majeure partie de la logique du formulaire dans le template. Cela donne une fausse impression de "quick win" au départ et le code devient rapidement difficile à maintenir et à tester.

1. ngModel

La Directive ngModel est au coeur des "Template-driven Forms".

Elle permet principalement de "binder" dans les deux sens le "model" avec la "view". C'est ce que l'on appelle le "Two-way Binding".

@Component({
    templateUrl: './book-form.component.html'
})
export class BookFormComponent {
    bookTitle: string;
}
<form>
    <input
        name="title"
        [(ngModel)]="bookTitle">
</form>

A chaque modification du "model", la "view" sera mise à jour et inversement.

La syntaxe [(property)]="data" n'est que du "syntactic sugar" pour signifier Input + Output.

Ce raccourci et automagiquement disponible s'il existe un Output portant exactement le même nom que l'Input avec le suffixe Change.

En voici la version longue :

<wt-something
    [property]="data"
    (propertyChange)="data = $event"></wt-something>

... ou pour ngModel :

<input
    name="title"
    [ngModel]="bookTitle"
    (ngModelChange)="bookTitle = $event">

Exemple de "Two-way Binding"

En utilisant le template HTML suivant :

<form>

    <input
            name="title"
            type="text"
            [(ngModel)]="bookTitle">
    <input
            name="title"
            type="text"
            [(ngModel)]="bookTitle">

    <div>{{ bookTitle }}</div>

</form>

... on peut constater le fonctionnement du "Two-way Binding" :

ngModel Two-way Binding

2. Détection du "submit" avec ngSubmit

Pour détecter le "submit" du formulaire, il faut utiliser l'Output ngSubmit sur l'élément form.

<form (ngSubmit)="submitBook()">

    <input
            name="title"
            type="text"
            [(ngModel)]="bookTitle">

    <button type="submit">SUBMIT</button>

</form>
export class BookFormComponent {

    bookTitle: string;

    submitBook() {
        console.log(this.bookTitle);
        /* Reset book's title. */
        this.bookTitle = null;
    }

}

submit vs ngSubmit

Two-way Binding vs. Immutabilité

L'un des principaux problème des "Template-driven Forms" est le non respect de l'immutabilité.

Supposons que le composant BookFormComponent décrit précédemment serve à éditer un objet Book.

export class BookFormComponent {

    @Input() book: Book;

    submitBook() {
    }

}
<form (ngSubmit)="submitBook()">

    <input
            name="title"
            type="text"
            [(ngModel)]="book.title">

    <button type="submit">SUBMIT</button>

</form>

Le "Two-way Binding" de la directive ngModel modifie directement la propriété title de l'objet book transmis par le composant parent.

Dès le premier caractère saisi, il est déjà trop tard car l'objet d'origine a été modifié et l'opération ne peut être annulée.

Dernière mise à jour