Le Guide Angular | Marmicode
  • Le Guide Angular par Marmicode
  • Pourquoi Angular ?
  • ECMAScript 6+
    • Un Peu d'Histoire
    • Propriétés du Langage
    • "Single-Threaded" donc Asynchrone
    • Event Loop
    • Classes
    • Hoisting is Dead: var vs. let vs. const
    • this & "binding"
    • Arrow Functions
    • Template Strings
    • Syntactic Sugar
      • Spread
      • Destructuring
      • Rest
      • Object Literal Property Value Shorthand
    • Named Parameters
    • Compatibilité
  • TypeScript
    • Pourquoi TypeScript ?
    • De l'ECMAScript au TypeScript
    • Visibilité des Propriétés
    • Typing des Propriétés
    • Types
    • Interfaces
    • Inference
    • Duck Typing
    • Duck Typing Patterns
      • Compatibilité de Librairies
      • Entity Constructor
    • Décorateurs
      • Décorateurs de Propriété
      • Décorateurs de Classe
      • Décorateurs de Méthode & Paramètres
    • Quelques Liens
  • Tools
    • Clavier mécanique
    • Git
    • Command Line
    • NodeJS
    • NPM
    • Yarn
      • Pourquoi Yarn ?
      • Définition et Installation des Dépendances
      • Scripts
      • Mise à Jour et Automatisation
    • Chrome
    • IntelliJ / WebStorm / VSCode
      • Raccourcis clavier IntelliJ / WebStorm
    • Floobits
    • Angular CLI
    • StackBlitz
    • Compodoc
  • Angular
    • Bootstrap
    • Composants
      • Root Component
      • Template Interpolation
      • Property Binding
      • Class & Style Binding
      • Event Binding
      • *ngIf
      • *ngFor
      • L'approche MVC
      • Création de Composants
      • Exemple
    • Container vs. Presentational Components
    • Interaction entre Composants
      • Input
      • Output
      • Exemple
    • Change Detection
      • Les Approches Possibles
      • Fonctionnement de la Change Detection
      • Optimisation de la Change Detection
      • Immutabilité
      • Quelques Liens
    • Project Structure & Modules
      • Entry Point
      • Définition d'un Module
      • Root Module
      • Feature Module
      • Shared Module
      • Exemple
    • Dependency Injection
      • Qu'est-ce que la "Dependency Injection" ?
      • Injection d'un Service Angular
      • Services & Providers
      • Portée des Services
      • Tree-Shakable Services
      • Class vs Injection Token
      • Exemple
    • Callback Hell vs. Promise vs. Async / Await
      • Callback Hell
      • Promise
      • Async / Await
    • Observables
      • Reactive Programming
      • Promise vs Observable
      • Subscribe
      • Unsubscribe ⚠️
      • Création d'un Observable
      • Opérateurs
        • Définition d'un Opérateur
        • Lettable Operators vs Legacy Methods
        • map
        • filter
        • mergeMap & switchMap
        • shareReplay
        • buffer
        • debounceTime
        • distinctUntilChanged
        • retry
      • Quelques Liens
      • Talks
    • Http
      • Pourquoi HttpClient ?
      • Utilisation de HttpClient
      • Utilisation dans un Service
      • Gestion de la Subscription ⚠️
    • State Management
      • Quelques Liens
      • Talks
    • GraphQL
    • Formulaires
      • Template-driven Forms 🤢
      • Reactive Forms 👍
        • Avantages des "Reactive Forms"
        • La boite à outils des "Reactive Forms"
        • Validation
        • Observation des Changements
    • Directives
      • Attribute Directive
      • Structural Directive
    • Pipes
    • Routing
      • Mise en Place du Routing
      • Lazy Loading
      • Project Structure
      • Route Guards
    • Testing
      • Unit-Testing
        • 📺Introduction au Test-Driven Development
        • Jasmine
        • Unit-Test Synchrone
        • Test-Driven Development
        • Unit-Test Asynchrone
        • TestBed
        • Unit-Test d'un Service
        • Unit-Test d'un Composant
        • Unit-Test et Spies
        • Unit-Test et HttpClient
      • End-to-End
      • Talks
    • Sécurité
      • Quelques Liens
    • Animation
    • Internationalisation
    • Quelques Liens
  • Cookbook
    • Authentification et Autorisation
    • Remplacement Dynamique de Composants
    • Lazy Loading without Router
    • Project Structure
    • SCAM Modules
    • Setup a Mock ReSTful API
  • Autres Ressources
  • Stay Tuned
    • 🎁-20% sur nos workshops avec le code GUIDEANGULAR
    • 🐦Suivez-moi !
    • 📺Cours Vidéo
    • 📬Newsletter
    • 📝Blog
  • Nos Services
    • Formation Angular
    • Atelier Unit-Testing Angular
    • Atelier Architecture Angular
    • Consultation à Distance & Code Review
  • Nos Guides
    • Guide Agile
    • Guide API ReST
    • Guide NodeJS
Propulsé par GitBook
Sur cette page
  • 1. ngModel
  • Exemple de "Two-way Binding"
  • 2. Détection du "submit" avec ngSubmit
  • submit vs ngSubmit
  • Two-way Binding vs. Immutabilité
  1. Angular
  2. Formulaires

Template-driven Forms 🤢

PrécédentFormulairesSuivantReactive Forms 👍

Dernière mise à jour il y a 5 ans

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 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 + .

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">

On obtient l'erreur suivante :

Can't bind to 'ngModel' since it isn't a known property of 'input'

Pour profiter de la directive NgModel, il faut importer le module FormsModule dans les modules contenant des composants qui en dépendent.

import { FormsModule } from '@angular/forms';

@NgModule({
    ...
    imports: [
        FormsModule
    ]
})
export class BookModule {
}

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" :

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;
    }

}

Préférez le "listener" de submit (via l'Output ngSubmit) sur le formulaire plutôt que le "listener" de click sur les boutons.

submit vs ngSubmit

Vous pouvez expérimenter la différence entre submit et ngSubmit en déclenchant une exception dans la méthode submitBook :

submitBook() {
    throw new Error(`D'OH!`);
}

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.

Il est bien sûr possible de détecter le changement de l'Input book est de créer une copie locale mais cela reste un contournement qui ne respecte pas l'une des bonnes pratiques de l'immutabilité qui consiste à ne cloner les objets que pour les modifier afin de pouvoir détecter les changements simplement en comparant les références.

... car l'Input ngModel est ajouté via la "directive" NgModel () mais cette "directive" n'est pas importée nativement.

Bien qu'il soit possible d'utiliser l' sur l'événement submit natif du formulaire, il est fortement recommandé d'utiliser l'Output ngSubmit ajouté par le module FormsModule.

Contrairement à l' sur l'événement submit, l'Output ngSubmit empêche le comportement par défaut du "browser" (requête GET avec les données du formulaires) via l'appel implicite de event.preventDefault() même si le "listener" associé produit une erreur.

Directive
Input
Output
https://github.com/angular/angular/blob/master/packages/forms/src/directives/ng_model.ts
Event Binding
Event Binding
ngModel Two-way Binding