| Package | mx.validators |
| Classe | public class EmailValidator |
| Héritage | EmailValidator  Validator EventDispatcher Object |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Vous pouvez utiliser des noms de domaines IP s’ils sont entourés de crochets ; par exemple, monnom@[206.132.22.1]. Vous pouvez utiliser des nombres IP compris entre 0 et 255.
Syntaxe MXML
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <mx:EmailValidator> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:EmailValidator
invalidCharError="Your e-mail address contains invalid characters."
invalidDomainError= "The domain in your e-mail address is incorrectly formatted."
invalidIPDomainError="The IP domain in your e-mail address is incorrectly formatted."
invalidPeriodsInDomainError="The domain in your e-mail address has consecutive periods."
missingAtSignError="An at sign (&64;) is missing in your e-mail address."
missingPeriodInDomainError="The domain in your e-mail address is missing a period."
missingUsernameError="The username in your e-mail address is missing."
tooManyAtSignsError="Your e-mail address contains too many &64; characters."
/>
Propriétés publiques
| Propriété | Défini par | ||
|---|---|---|---|
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| enabled : Boolean
Si cette valeur est définie sur false, le programme de validation arrête la validation. | Validator | |
| invalidCharError : String
Message d’erreur lorsque l’adresse électronique contient des caractères non valides. | EmailValidator | ||
| invalidDomainError : String
Message d’erreur lorsque le suffixe (domaine de niveau supérieur) ne fait pas 2, 3, 4 ou 6 caractères de long. | EmailValidator | ||
| invalidIPDomainError : String
Message d’erreur lorsque le domaine IP n’est pas valide. | EmailValidator | ||
| invalidPeriodsInDomainError : String
Message d’erreur lorsque le domaine contient des points continus. | EmailValidator | ||
| listener : Object
Spécifie l’écouteur de validation. | Validator | |
| missingAtSignError : String
Message d’erreur lorsque l’adresse électronique ne contient aucun signe @. | EmailValidator | ||
| missingPeriodInDomainError : String
Message d’erreur lorsque le domaine ne contient aucun point. | EmailValidator | ||
| missingUsernameError : String
Message d’erreur lorsqu’il n’y a aucun nom d’utilisateur. | EmailValidator | ||
| property : String
Chaîne spécifiant le nom de la propriété de l’objet source qui contient la valeur à valider. | Validator | |
| required : Boolean = true
Si true, indique qu’une valeur manquante ou vide provoque une erreur de validation. | Validator | |
| requiredFieldError : String
Message d’erreur lorsqu’une valeur est manquante et que la propriété requise est true. | Validator | |
| source : Object
Spécifie l’objet contenant la propriété à valider. | Validator | |
| tooManyAtSignsError : String
Message d’erreur lorsque l’adresse électronique contient plus d’un signe @. | EmailValidator | ||
| trigger : IEventDispatcher
Spécifie le composant qui génère l’événement déclenchant le programme de validation. | Validator | |
| triggerEvent : String
Spécifie l’événement qui déclenche la validation. | Validator | |
Propriétés protégées
Méthodes publiques
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | EmailValidator | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | |
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Appelé automatiquement par le compilateur MXML lorsque la classe Validator est créée à l’aide d’une balise MXML. | Validator | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Procède à la validation et, le cas échéant, informe les écouteurs du résultat. | Validator | |
| [statique]
Invoque tous les objets Validator dans le tableau d’objets Validator. | Validator | |
[statique]
Méthode pratique pour appeler une classe Validator dans une fonction de validation personnalisée. | EmailValidator | ||
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher | |
Méthodes protégées
| Méthode | Défini par | ||
|---|---|---|---|
|
Définit tous les écouteurs pour les événements valid et invalid distribués à partir du programme de validation. | Validator | |
[override]
Remplace la méthode doValidation() de la classe de base pour valider une adresse électronique. | EmailValidator | ||
|
Renvoie l’objet à valider. | Validator | |
|
Renvoie une classe ValidationResultEvent depuis le tableau des résultats d’erreurs. | Validator | |
|
Renvoie true si la valeur n’est pas nulle. | Validator | |
|
Déconnecte tous les écouteurs pour les événements valid et invalid distribués à partir du programme de validation. | Validator | |
|
Cette méthode est appelée lorsqu’une classe Validator est construite et chaque fois que la classe ResourceManager distribue un événement « change » pour indiquer que les ressources localisées ont changé d’une manière ou d’une autre. | Validator | |
Evénements
Constantes protégées
Détails de la propriété
invalidCharError | propriété |
invalidCharError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Message d’erreur lorsque l’adresse électronique contient des caractères non valides.
La valeur par défaut est "Your e-mail address contains invalid characters.".
Implémentation
public function get invalidCharError():String public function set invalidCharError(value:String):voidinvalidDomainError | propriété |
invalidDomainError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Message d’erreur lorsque le suffixe (domaine de niveau supérieur) ne fait pas 2, 3, 4 ou 6 caractères de long.
La valeur par défaut est "The domain in your e-mail address is incorrectly formatted.".
Implémentation
public function get invalidDomainError():String public function set invalidDomainError(value:String):voidinvalidIPDomainError | propriété |
invalidIPDomainError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Message d’erreur lorsque le domaine IP n’est pas valide. Le domaine IP doit être entouré de crochets.
La valeur par défaut est "The IP domain in your e-mail address is incorrectly formatted.".
Implémentation
public function get invalidIPDomainError():String public function set invalidIPDomainError(value:String):voidinvalidPeriodsInDomainError | propriété |
invalidPeriodsInDomainError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Message d’erreur lorsque le domaine contient des points continus.
La valeur par défaut est "The domain in your e-mail address has continous periods.".
Implémentation
public function get invalidPeriodsInDomainError():String public function set invalidPeriodsInDomainError(value:String):voidmissingAtSignError | propriété |
missingAtSignError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Message d’erreur lorsque l’adresse électronique ne contient aucun signe @.
La valeur par défaut est "An at sign (&64;) is missing in your e-mail address.".
Implémentation
public function get missingAtSignError():String public function set missingAtSignError(value:String):voidmissingPeriodInDomainError | propriété |
missingPeriodInDomainError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Message d’erreur lorsque le domaine ne contient aucun point.
La valeur par défaut est "The domain in your e-mail address is missing a period.".
Implémentation
public function get missingPeriodInDomainError():String public function set missingPeriodInDomainError(value:String):voidmissingUsernameError | propriété |
missingUsernameError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Message d’erreur lorsqu’il n’y a aucun nom d’utilisateur.
La valeur par défaut est "The username in your e-mail address is missing.".
Implémentation
public function get missingUsernameError():String public function set missingUsernameError(value:String):voidtooManyAtSignsError | propriété |
tooManyAtSignsError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Message d’erreur lorsque l’adresse électronique contient plus d’un signe @. Cette propriété est facultative.
La valeur par défaut est "Your e-mail address contains too many &64; characters.".
Implémentation
public function get tooManyAtSignsError():String public function set tooManyAtSignsError(value:String):voidDétails du constructeur
EmailValidator | () | Constructeur |
public function EmailValidator()| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
Détails de la méthode
doValidation | () | méthode |
override protected function doValidation(value:Object):Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Remplace la méthode doValidation() de la classe de base pour valider une adresse électronique.
Vous n’appelez pas cette méthode directement ; Flex l’appelle dans le cadre d’une validation. Si vous créez une classe Validator personnalisée, vous devez implémenter cette méthode.
Paramètres
value:Object — Classe String ou classe Object à valider.
|
Array — Tableau d’objets ValidationResult, avec un objet ValidationResult pour chaque champ examiné par le programme de validation.
|
validateEmail | () | méthode |
public static function validateEmail(validator:EmailValidator, value:Object, baseField:String):Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Méthode pratique pour appeler une classe Validator dans une fonction de validation personnalisée. Chacune des classes Validator Flex standard comporte une méthode pratique similaire.
Paramètres
validator:EmailValidator — Instance EmailValidator.
| |
value:Object — Champ à valider.
| |
baseField:String — Représentation textuelle du sous-champ spécifié dans le paramètre value. Par exemple, si le paramètre value spécifie value.email, la valeur baseField est « email ».
|
Array — Tableau d’objets ValidationResult, avec un objet ValidationResult pour chaque champ examiné par le programme de validation.
|
Eléments de l’API associés
Exemples Comment utiliser cet exemple
EmailValidatorExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the EmailValidator. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx">
<fx:Script>
import mx.controls.Alert;
</fx:Script>
<fx:Declarations>
<mx:EmailValidator source="{email}" property="text"
trigger="{myButton}" triggerEvent="click"
valid="Alert.show('Validation Succeeded!');"/>
</fx:Declarations>
<s:Panel title="EmailValidator Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<mx:Form left="10" right="10" top="10" bottom="10">
<mx:FormItem label="Enter an e-mail address: ">
<s:TextInput id="email" width="100%"/>
</mx:FormItem>
<mx:FormItem >
<s:Button id="myButton" label="Validate" />
</mx:FormItem>
</mx:Form>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 09:30 AM Z