Formations — 1 037 leçons en français

Accueil › Angular › Formulaires template et aperçu des Signal Forms

Formulaires template et aperçu des Signal Forms

Les formulairesdebutant

Les formulaires template décrivent le formulaire directement dans le HTML, avec ngModel, plutôt qu'en TypeScript. Il faut ajouter FormsModule aux imports :

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

@Component({
  selector: 'app-contact',
  imports: [FormsModule],
  templateUrl: './contact.html',
})
export class Contact {
  client = { nom: '', email: '' };

  soumettre() {
    console.log(this.client);
  }
}
<form #contactForm="ngForm" (ngSubmit)="soumettre()">
  <input name="nom" [(ngModel)]="client.nom" required minlength="2" #nom="ngModel" />
  @if (nom.invalid && nom.touched) {
    <p>Nom invalide</p>
  }

  <input name="email" [(ngModel)]="client.email" required email />

  <button type="submit" [disabled]="contactForm.invalid">Envoyer</button>
</form>

[(ngModel)] synchronise la propriété avec le champ. La validation se pose en attributs HTML (required, minlength, email). #contactForm="ngForm" expose l'objet NgForm avec sa validité globale.

Ce mode convient à un formulaire simple et statique. Pour un formulaire avec beaucoup de logique (validation croisée, champs dynamiques), le formulaire réactif (leçons précédentes) reste plus adapté.

Les termes à connaître

FormsModule

Module à ajouter aux imports d'un composant standalone pour utiliser les formulaires template, basés sur ngModel et les directives de validation posées directement dans le HTML.

ngModel / [(ngModel)]

Directive qui synchronise un champ de formulaire avec une propriété du composant. [(ngModel)] (liaison bidirectionnelle) combine lecture ([ngModel]) et écriture ((ngModelChange)) en une seule syntaxe.

#form="ngForm"

Référence de template qui expose l'objet NgForm créé automatiquement par Angular pour la balise <form>, avec sa validité globale (form.valid) et l'état de chaque champ (form.controls.email).

Validation dans le template

Dans un formulaire template, les règles de validation sont des attributs HTML (required, minlength, email via ngModel seul suffit pour le type email), pas des objets TypeScript comme dans les formulaires réactifs.

Signal Forms (@angular/forms/signals)

API expérimentale introduite en Angular 21.0, qui construit un formulaire à partir d'un signal() avec form(). Statut : aperçu à essayer, non recommandé en production pour l'instant.

[formField]

Directive de liaison des Signal Forms, à poser sur un champ pour le relier à un nœud du formulaire (ex. [formField]="loginForm.email"). Nommée [field] à la sortie d'Angular 21.0.0, renommée [formField] dès le correctif 21.0.9.

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.