Formations — 1 037 leçons en français

Accueil › Angular › Valider un formulaire

Valider un formulaire

Les formulairesdebutant

Un FormControl accepte une liste de validateurs, appliqués automatiquement à chaque changement de valeur :

inscriptionForm = this.fb.group({
  email: ['', [Validators.required, Validators.email]],
  motDePasse: ['', [Validators.required, Validators.minLength(8)]],
});

Le contrôle expose ensuite son état : valid, invalid, et errors (un objet détaillant chaque validateur en échec, ou null si tout est valide). Il expose aussi son historique d'interaction : pristine/dirty (la valeur a-t-elle changé ?) et touched/untouched (le champ a-t-il été visité ?).

Ces deux états servent à décider quand afficher une erreur : afficher invalid seul montrerait une erreur dès le chargement de la page, avant toute saisie. La pratique courante est de combiner les deux :

@if (form.controls.email.invalid && form.controls.email.touched) {
  <p class="erreur">
    @if (form.controls.email.hasError('required')) { L'adresse e-mail est obligatoire }
    @if (form.controls.email.hasError('email')) { Format d'adresse invalide }
  </p>
}

Pour désactiver le bouton de soumission tant que le formulaire n'est pas valide : <button [disabled]="inscriptionForm.invalid">.

Les termes à connaître

Validators.required, minLength, email, pattern

Validateurs intégrés (@angular/forms) appliqués à un FormControl. required refuse une valeur vide, minLength(n) une chaîne trop courte, email un format d'adresse invalide, pattern(regex) une chaîne qui ne correspond pas à l'expression régulière.

valid / invalid

États d'un FormControl ou FormGroup : valid vaut true si tous les validateurs passent. invalid est son opposé. Un FormGroup est invalid dès qu'un seul de ses contrôles l'est.

touched / dirty / pristine

touched : le contrôle a reçu puis perdu le focus au moins une fois. dirty : sa valeur a changé depuis sa création (opposé : pristine). Servent à décider quand afficher une erreur, pas seulement si elle existe.

errors / hasError

control.errors est un objet (ou null si valide) dont chaque clé est le nom d'un validateur en échec, ex. { required: true }. control.hasError('required') est un raccourci pratique dans le template.

Validateur personnalisé

Fonction (control: AbstractControl) => ValidationErrors | null qui applique une règle métier absente des validateurs intégrés, ex. vérifier le format d'une référence produit.

Validateur asynchrone

Fonction qui renvoie un Observable<ValidationErrors | null> (ou une Promise), utilisée pour une vérification qui nécessite un appel serveur (ex. un e-mail déjà utilisé). Passée en 3ᵉ position dans fb.group.

Validateur au niveau du groupe

Validateur posé sur un FormGroup plutôt que sur un FormControl, pour une règle qui compare plusieurs champs entre eux (ex. confirmation de mot de passe). L'erreur apparaît sur group.errors, pas sur un contrôle précis.

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.