| Package | mx.validators |
| Classe | public class ZipCodeValidator |
| Héritage | ZipCodeValidator  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 |
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <mx:ZipCodeValidator> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:ZipCodeValidator
allowedFormatChars=" -"
domain="US Only | US or Canada | Canada Only"
invalidCharError="The ZIP code contains invalid characters."
invalidDomainError="The domain parameter is invalid. It must be either 'US Only', 'Canada Only', or 'US or Canada'."
wrongCAFormatError="The Canadian postal code must be formatted 'A1B 2C3'."
wrongLengthError="The ZIP code must be 5 digits or 5+4 digits."
wrongUSFormatError="The ZIP+4 code must be formatted '12345-6789'."
/>
Eléments de l’API associés
Propriétés publiques
| Propriété | Défini par | ||
|---|---|---|---|
| allowedFormatChars : String
Jeu de caractères de formatage autorisés dans le code postal. | ZipCodeValidator | ||
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| domain : String
Type de code postal à vérifier. | ZipCodeValidator | ||
| 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 le code postal contient des caractères non valides. | ZipCodeValidator | ||
| invalidDomainError : String
Message d’erreur lorsque la propriété domain contient une valeur non valide. | ZipCodeValidator | ||
| listener : Object
Spécifie l’écouteur de validation. | Validator | |
| 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 | |
| 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 | |
| wrongCAFormatError : String
Message d’erreur pour un code postal canadien non valide. | ZipCodeValidator | ||
| wrongLengthError : String
Message d’erreur pour un code postal américain non valide. | ZipCodeValidator | ||
| wrongUSFormatError : String
Message d’erreur pour un code postal mal formaté. | ZipCodeValidator | ||
Propriétés protégées
Méthodes publiques
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | ZipCodeValidator | ||
| 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. | ZipCodeValidator | ||
|
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 un code postal. | ZipCodeValidator | ||
|
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é
allowedFormatChars | propriété |
allowedFormatChars:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Jeu de caractères de formatage autorisés dans le code postal. Ne peut pas contenir des chiffres ou des lettres [a-z A-Z].
La valeur par défaut est " -"..
Implémentation
public function get allowedFormatChars():String public function set allowedFormatChars(value:String):voiddomain | propriété |
domain:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Type de code postal à vérifier. Dans MXML, les valeurs possibles sont "US or Canada", "US Only" et "Canada Only".
Dans ActionScript, vous pouvez utiliser les constantes suivantes pour définir cette propriété : ZipCodeValidatorDomainType.US_ONLY, ZipCodeValidatorDomainType.US_OR_CANADA ou ZipCodeValidatorDomainType.CANADA_ONLY.
La valeur par défaut est ZipCodeValidatorDomainType.US_ONLY.
Implémentation
public function get domain():String public function set domain(value:String):voidinvalidCharError | 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 le code postal contient des caractères non valides.
La valeur par défaut est "The ZIP code 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 la propriété domain contient une valeur non valide.
La valeur par défaut est "The domain parameter is invalid. It must be either 'US Only' or 'US or Canada'.".
Implémentation
public function get invalidDomainError():String public function set invalidDomainError(value:String):voidwrongCAFormatError | propriété |
wrongCAFormatError: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 pour un code postal canadien non valide.
La valeur par défaut est "The Canadian postal code must be formatted 'A1B 2C3'.".
Implémentation
public function get wrongCAFormatError():String public function set wrongCAFormatError(value:String):voidwrongLengthError | propriété |
wrongLengthError: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 pour un code postal américain non valide.
La valeur par défaut est "The ZIP code must be 5 digits or 5+4 digits.".
Implémentation
public function get wrongLengthError():String public function set wrongLengthError(value:String):voidwrongUSFormatError | propriété |
wrongUSFormatError: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 pour un code postal mal formaté.
La valeur par défaut est "The ZIP+4 code must be formatted '12345-6789'.".
Implémentation
public function get wrongUSFormatError():String public function set wrongUSFormatError(value:String):voidDétails du constructeur
ZipCodeValidator | () | Constructeur |
public function ZipCodeValidator()| 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 un code postal.
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 — Objet à valider.
|
Array — Tableau d’objets ValidationResult, avec un objet ValidationResult pour chaque champ examiné par le programme de validation.
|
validateZipCode | () | méthode |
public static function validateZipCode(validator:ZipCodeValidator, 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. Chacune des classes Validator Flex standard comporte une méthode pratique similaire.
Paramètres
validator:ZipCodeValidator — Instance ZipCodeValidator.
| |
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.zipCode, la valeur baseField est "zipCode".
|
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
ZipCodeValidatorExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the ZipCodeValidator. -->
<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:ZipCodeValidator source="{zip}" property="text"
trigger="{myButton}" triggerEvent="click"
valid="Alert.show('Validation Succeeded!');"
invalid="Alert.show('Validation Failed!');"/>
</fx:Declarations>
<s:Panel title="ZipcodeValidator Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<mx:Form left="10" right="10" top="10" bottom="10">
<mx:FormItem label="Enter a 5 or 9 digit U.S. Zip code: ">
<s:TextInput id="zip" 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