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 à unFormControl.requiredrefuse une valeur vide,minLength(n)une chaîne trop courte,emailun format d'adresse invalide,pattern(regex)une chaîne qui ne correspond pas à l'expression régulière.- valid / invalid
États d'un
FormControlouFormGroup:validvauttruesi tous les validateurs passent.invalidest son opposé. UnFormGroupestinvaliddè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.errorsest un objet (ounullsi 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 | nullqui 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 unePromise), utilisée pour une vérification qui nécessite un appel serveur (ex. un e-mail déjà utilisé). Passée en 3ᵉ position dansfb.group.- Validateur au niveau du groupe
Validateur posé sur un
FormGroupplutôt que sur unFormControl, pour une règle qui compare plusieurs champs entre eux (ex. confirmation de mot de passe). L'erreur apparaît surgroup.errors, pas sur un contrôle précis.
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.