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
importsd'un composant standalone pour utiliser les formulaires template, basés surngModelet 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
NgFormcréé 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,emailviangModelseul suffit pour le typeemail), 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()avecform(). 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.
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.