A propos du widget Zone de texte de validation

Le widget Validation Spry de zone de texte est une zone de texte qui affiche des états valides ou non valides lorsque le visiteur du site entre quelques lignes de texte. Si la zone de texte est un champ obligatoire et que l'utilisateur n'y entre pas de texte, le widget affiche un message indiquant qu'une valeur est requise.

L'exemple suivant montre un widget Zone de texte de validation dans différents états :

Afficher le graphique à sa taille d'origine

A.

Compteur de caractères restants

B.

Widget Zone de texte activé, nombre maximal de caractères

C.

Widget Zone de texte activé, état valide

D.

Widget Zone de texte, état obligatoire

E.

Compteur de caractères tapés

Le widget Zone de texte de validation peut posséder divers états (par exemple valide, non valide, valeur obligatoire, etc.). Vous pouvez modifier les propriétés de ces états à l'aide de l'inspecteur Propriétés, en fonction des résultats de validation désirés. Un widget Zone de texte de validation peut effectuer une validation à différents moments, par exemple lorsque le visiteur clique en dehors du widget, pendant qu'il entre des données ou lorsqu'il tente d'envoyer le formulaire.

Etat initial

Etat du widget lorsque la page se charge dans le navigateur, ou lorsque l'utilisateur réinitialise le formulaire.

Etat actif

Etat du widget lorsque l'utilisateur place le point d'insertion à l'intérieur.

Etat valide

Etat du widget lorsque l'utilisateur a entré des informations correctes, ce qui permet l'envoi du formulaire.

Etat obligatoire

Etat du widget si l'utilisateur n'a pas entré de texte.

Nombre minimal de caractères

Etat du widget lorsque l'utilisateur a entré moins de caractères que le nombre minimal requis pour la zone de texte.

Nombre maximal de caractères

Etat du widget lorsque l'utilisateur a entré plus de caractères que le nombre maximal admis pour la zone de texte.

Lorsqu'un widget Zone de texte de validation passe dans l'un de ces états suite à l'interaction avec l'utilisateur, la logique du cadre applicatif Spry applique une classe CSS spécifique au conteneur HTML pour le widget lors de l'exécution. Par exemple, si un utilisateur tente d'envoyer un formulaire mais n'a pas entré de texte dans la zone de texte, Spry applique au widget une classe qui le force à afficher le message d'erreur « Vous devez entrer une valeur ». Les règles qui contrôlent le style et les états d'affichage de messages d'erreur se trouvent dans le fichier CSS qui accompagne le widget, SpryValidationTextArea.css.

Le code HTML par défaut du widget Zone de texte de validation, généralement dans un formulaire, contient une balise conteneur <span> qui entoure la balise <textarea> de la zone de texte. Le code HTML du widget Zone de texte de validation comprend également des balises script dans l'en-tête du document et après le marquage HTML du widget.

Vous trouverez une explication plus détaillée du fonctionnement du widget Zone de texte de validation, ainsi qu'une description complète de son code, à l'adresse www.adobe.com/go/learn_dw_sprytextarea_fr.