| Package | mx.validators |
| Classe | public class CreditCardValidator |
| Héritage | CreditCardValidator  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 spécifier l’entrée dans la classe CreditCardValidator de deux manières :
- Utilisez les propriétés
cardNumberSourceetcardNumberPropertypour spécifier l’emplacement du numéro de carte de crédit et les propriétéscardTypeSourceetcardTypePropertypour spécifier l’emplacement du type de carte de crédit à valider. - Utilisez les propriétés
sourceetpropertypour spécifier un seul objet. L’objet doit contenir les champs suivants :-
cardType- Spécifie le type de la carte de crédit en cours de validation.Dans MXML, utilisez les valeurs :
"American Express","Diners Club","Discover","MasterCard"ou"Visa".Dans ActionScript, utilisez les constantes statiques
CreditCardValidatorCardType.MASTER_CARD,CreditCardValidatorCardType.VISA,CreditCardValidatorCardType.AMERICAN_EXPRESSCreditCardValidatorCardType.DISCOVERouCreditCardValidatorCardType.DINERS_CLUB. -
cardNumber- Spécifie le numéro de la carte de crédit en cours de validation.
-
Pour procéder à la validation, les instructions suivantes sont observées :
Durée:
- Visa : 13 ou 16 chiffres
- MasterCard : 16 chiffres
- Discover : 16 chiffres
- American Express : 15 chiffres
- Diners Club : 14 ou 16 chiffres si elle fonctionne aussi comme une carte MasterCard
- Visa : 4
- MasterCard : 51 à 55
- Discover : 6011
- American Express : 34 ou 37
- Diners Club : 300 à 305, 36 ou 38, 51 à 55
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <mx:CreditCardValidator> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:CreditCardValidator
allowedFormatChars=" -"
cardNumberListener="Object specified by cardNumberSource"
cardNumberProperty="No default"
cardNumberSource="No default"
cardTypeListener="Object specified by cardTypeSource"
cardTypeProperty="No default"
cardTypeSource="No default"
invalidCharError= "Invalid characters in your credit card number. (Enter numbers only.)"
invalidNumberError="The credit card number is invalid."
noNumError="No credit card number is specified."
noTypeError="No credit card type is specified or the type is not valid."
wrongLengthError="Your credit card number contains the wrong number of digits."
wrongTypeError="Incorrect card type is specified."
/>
Eléments de l’API associés
| Propriété | Défini par | ||
|---|---|---|---|
| allowedFormatChars : String
Jeu de caractères de formatage autorisés dans le champ cardNumber. | CreditCardValidator | ||
| cardNumberListener : IValidatorListener
Composant qui écoute le résultat de validation pour le sous-champ de numéro de carte. | CreditCardValidator | ||
| cardNumberProperty : String
Nom de la propriété card number à valider. | CreditCardValidator | ||
| cardNumberSource : Object
Objet contenant la valeur du champ de numéro de carte. | CreditCardValidator | ||
| cardTypeListener : IValidatorListener
Composant qui écoute le résultat de validation pour le sous-champ de type de carte. | CreditCardValidator | ||
| cardTypeProperty : String
Nom de la propriété card type à valider. | CreditCardValidator | ||
| cardTypeSource : Object
Objet contenant la valeur du champ de type de carte. | CreditCardValidator | ||
 | 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 le champ cardNumber contient des caractères non valides. | CreditCardValidator | ||
| invalidNumberError : String
Message d’erreur lorsque le champ de numéro de carte de crédit n’est pas valide. | CreditCardValidator | ||
| listener : Object
Spécifie l’écouteur de validation. | Validator | |
| noNumError : String
Message d’erreur lorsque le champ cardNumber est vide. | CreditCardValidator | ||
| noTypeError : String
Message d’erreur lorsque le champ cardType est vide. | CreditCardValidator | ||
| 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 | |
| wrongLengthError : String
Message d’erreur lorsque le champ cardNumber ne contient pas le nombre correct de chiffres pour le type de carte de crédit spécifié. | CreditCardValidator | ||
| wrongTypeError : String
Message d’erreur lorsque le champ cardType contient un type de carte de crédit non valide. | CreditCardValidator | ||
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | CreditCardValidator | ||
| 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. | CreditCardValidator | ||
|
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é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 numéro de carte de crédit. | CreditCardValidator | ||
|
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 | |
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 champ cardNumber.
La valeur par défaut est " -" (space and dash).
Implémentation
public function get allowedFormatChars():String public function set allowedFormatChars(value:String):voidcardNumberListener | propriété |
cardNumberListener:IValidatorListener| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Composant qui écoute le résultat de validation pour le sous-champ de numéro de carte. Si aucune valeur n’est spécifiée, utilisez la valeur spécifiée pour la propriété cardNumberSource.
Implémentation
public function get cardNumberListener():IValidatorListener public function set cardNumberListener(value:IValidatorListener):voidcardNumberProperty | propriété |
public var cardNumberProperty:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nom de la propriété card number à valider. Cette propriété est facultative, mais si vous spécifiez la propriété cardNumberSource, définissez également cette propriété.
cardNumberSource | propriété |
cardNumberSource:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Objet contenant la valeur du champ de numéro de carte. Si vous spécifiez une valeur pour cette propriété, vous devez aussi en spécifier une pour la propriété cardNumberProperty. N’utilisez pas cette propriété si vous définissez les propriétés source et property.
Implémentation
public function get cardNumberSource():Object public function set cardNumberSource(value:Object):voidcardTypeListener | propriété |
cardTypeListener:IValidatorListener| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Composant qui écoute le résultat de validation pour le sous-champ de type de carte. Si aucune valeur n’est spécifiée, utilisez la valeur spécifiée pour la propriété cardTypeSource.
Implémentation
public function get cardTypeListener():IValidatorListener public function set cardTypeListener(value:IValidatorListener):voidcardTypeProperty | propriété |
public var cardTypeProperty:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nom de la propriété card type à valider. Cette propriété est facultative, mais si vous spécifiez la propriété cardTypeSource, définissez également cette propriété.
Dans MXML, les valeurs possibles sont les suivantes :
"American Express""Diners Club""Discover""MasterCard""Visa"
Dans ActionScript, vous pouvez utiliser les constantes suivantes pour définir cette propriété :
CreditCardValidatorCardType.AMERICAN_EXPRESS, CreditCardValidatorCardType.DINERS_CLUB, CreditCardValidatorCardType.DISCOVER, CreditCardValidatorCardType.MASTER_CARD et CreditCardValidatorCardType.VISA.
Eléments de l’API associés
cardTypeSource | propriété |
cardTypeSource:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Objet contenant la valeur du champ de type de carte. Si vous spécifiez une valeur pour cette propriété, vous devez aussi en spécifier une pour la propriété cardTypeProperty. N’utilisez pas cette propriété si vous définissez les propriétés source et property.
Implémentation
public function get cardTypeSource():Object public function set cardTypeSource(value:Object):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 champ cardNumber contient des caractères non valides.
La valeur par défaut est "Invalid characters in your credit card number. (Enter numbers only.)".
Implémentation
public function get invalidCharError():String public function set invalidCharError(value:String):voidinvalidNumberError | propriété |
invalidNumberError: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 champ de numéro de carte de crédit n’est pas valide.
La valeur par défaut est "The credit card number is invalid.".
Implémentation
public function get invalidNumberError():String public function set invalidNumberError(value:String):voidnoNumError | propriété |
noNumError: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 champ cardNumber est vide.
La valeur par défaut est "No credit card number is specified.".
Implémentation
public function get noNumError():String public function set noNumError(value:String):voidnoTypeError | propriété |
noTypeError: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 champ cardType est vide.
La valeur par défaut est "No credit card type is specified or the type is not valid.".
Implémentation
public function get noTypeError():String public function set noTypeError(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 lorsque le champ cardNumber ne contient pas le nombre correct de chiffres pour le type de carte de crédit spécifié.
La valeur par défaut est "Your credit card number contains the wrong number of digits.".
Implémentation
public function get wrongLengthError():String public function set wrongLengthError(value:String):voidwrongTypeError | propriété |
wrongTypeError: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 champ cardType contient un type de carte de crédit non valide. Utilisez les constantes prédéfinies pour le champ cardType : CreditCardValidatorCardType.MASTER_CARD, CreditCardValidatorCardType.VISA, CreditCardValidatorCardType.AMERICAN_EXPRESS, CreditCardValidatorCardType.DISCOVER ou CreditCardValidatorCardType.DINERS_CLUB.
La valeur par défaut est "Incorrect card type is specified.".
Implémentation
public function get wrongTypeError():String public function set wrongTypeError(value:String):voidCreditCardValidator | () | Constructeur |
public function CreditCardValidator()| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
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 numéro de carte de crédit.
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.
|
validateCreditCard | () | méthode |
public static function validateCreditCard(validator:CreditCardValidator, 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:CreditCardValidator — Instance CreditCardValidator.
| |
value:Object — Champ à valider, qui doit contenir les champs suivants :
| |
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.date, la valeur baseField est « date ».
|
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
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the CreditCardValidator. -->
<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>
<!-- Define model for the credit card data. -->
<fx:Model id="creditcard">
<card>
<cardType>{cardTypeCombo.selectedItem.data}</cardType>
<cardNumber>{cardNumberInput.text}</cardNumber>
</card>
</fx:Model>
<mx:CreditCardValidator id="ccV"
cardTypeSource="{creditcard}" cardTypeProperty="cardType"
cardNumberSource="{creditcard}" cardNumberProperty="cardNumber"
trigger="{myButton}" triggerEvent="click"
cardTypeListener="{cardTypeCombo}"
cardNumberListener="{cardNumberInput}"
valid="Alert.show('Validation Succeeded!');"/>
</fx:Declarations>
<s:Panel title="CreditCardValidator Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<mx:Form id="creditCardForm" left="10" right="10" top="10" bottom="10">
<mx:FormItem label="Card Type">
<mx:ComboBox id="cardTypeCombo">
<mx:dataProvider>
<fx:Object label="American Express" data="American Express"/>
<fx:Object label="Diners Club" data="Diners Club"/>
<fx:Object label="Discover" data="Discover"/>
<fx:Object label="MasterCard" data="MasterCard"/>
<fx:Object label="Visa" data="Visa"/>
</mx:dataProvider>
</mx:ComboBox>
</mx:FormItem>
<mx:FormItem label="Credit Card Number">
<s:TextInput id="cardNumberInput"/>
</mx:FormItem>
<mx:FormItem>
<s:Button id="myButton" label="Check Credit"/>
</mx:FormItem>
</mx:Form>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 09:30 AM Z