CreditCardValidator

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

La classe CreditCardValidator valide le fait qu’un numéro de carte de crédit a la longueur correcte, comporte le préfixe correct et transmet l’algorithme Luhn mod10 du type de carte spécifié. Ce programme de validation ne vérifie pas si la carte de crédit est un compte de carte de crédit actif réel.

Vous pouvez spécifier l’entrée dans la classe CreditCardValidator de deux manières :

Utilisez les propriétés cardNumberSource et cardNumberProperty pour spécifier l’emplacement du numéro de carte de crédit et les propriétés cardTypeSource et cardTypeProperty pour spécifier l’emplacement du type de carte de crédit à valider.
Utilisez les propriétés source et property pour 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_EXPRESS CreditCardValidatorCardType.DISCOVER ou CreditCardValidatorCardType.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

Préfixe :

Visa : 4
MasterCard : 51 à 55
Discover : 6011
American Express : 34 ou 37
Diners Club : 300 à 305, 36 ou 38, 51 à 55

Syntaxe MXML expanded

Masquer la syntaxe MXML

The <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." 
  />

Consulter les exemples

Eléments de l’API associés

mx.validators.CreditCardValidatorCardType

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	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

Propriétés protégées

Masquer les propriétés protégées héritées

Afficher les propriétés protégées héritées

	Propriété		Défini par
		actualListeners : Array [lecture seule] Contient un tableau d’objets d’écouteurs, le cas échéant, ou l’objet source.	Validator
		actualTrigger : IEventDispatcher [lecture seule] Contient l’objet déclencheur, le cas échéant, ou l’objet source.	Validator
		resourceManager : IResourceManager [lecture seule] Référence à l’objet qui gère toutes les ressources localisées de l’application.	Validator
		subFields : Array Tableau de chaînes contenant les noms des propriétés contenues dans l’objet value transmis à la méthode validate().	Validator

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		CreditCardValidator() 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
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		initialized(document:Object, id:String):void Appelé automatiquement par le compilateur MXML lorsque la classe Validator est créée à l’aide d’une balise MXML.	Validator
		isPrototypeOf(theClass:Object):Boolean 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
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent Procède à la validation et, le cas échéant, informe les écouteurs du résultat.	Validator
		validateAll(validators:Array):Array [statique] Invoque tous les objets Validator dans le tableau d’objets Validator.	Validator
		validateCreditCard(validator:CreditCardValidator, value:Object, baseField:String):Array [statique] Méthode pratique pour appeler une classe Validator.	CreditCardValidator
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean 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

Masquer les méthodes protégées héritées

Afficher les méthodes protégées héritées

	Méthode		Défini par
		addListenerHandler():void Définit tous les écouteurs pour les événements valid et invalid distribués à partir du programme de validation.	Validator
		doValidation(value:Object):Array [override] Remplace la méthode doValidation() de la classe de base pour valider un numéro de carte de crédit.	CreditCardValidator
		getValueFromSource():Object Renvoie l’objet à valider.	Validator
		handleResults(errorResults:Array):ValidationResultEvent Renvoie une classe ValidationResultEvent depuis le tableau des résultats d’erreurs.	Validator
		isRealValue(value:Object):Boolean Renvoie true si la valeur n’est pas nulle.	Validator
		removeListenerHandler():void Déconnecte tous les écouteurs pour les événements valid et invalid distribués à partir du programme de validation.	Validator
		resourcesChanged():void 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

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher
invalid	Distribué si la validation échoue.	Validator
valid	Distribué si la validation réussit.	Validator

Constantes protégées

Masquer les constantes protégées héritées

Afficher les constantes protégées héritées

	Constante		Défini par

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 champ cardNumber.

La valeur par défaut est " -" (space and dash).

Implémentation
public function get allowedFormatChars():String
public function set allowedFormatChars(value:String):void

cardNumberListener

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):void

cardNumberProperty

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):void

cardTypeListener

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):void

cardTypeProperty

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

mx.validators.CreditCardValidatorCardType

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):void

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 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):void

invalidNumberError

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):void

noNumError

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):void

noTypeError

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):void

wrongLengthError

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):void

wrongTypeError

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):void

Détails du constructeur

()

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.

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 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.

Valeur renvoyée

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 : `cardType` - Spécifie le type de la carte de crédit en cours de validation. Utilisez les constantes statiques `CreditCardValidatorCardType.MASTER_CARD`, `CreditCardValidatorCardType.VISA`, `CreditCardValidatorCardType.AMERICAN_EXPRESS`, `CreditCardValidatorCardType.DISCOVER` ou `CreditCardValidatorCardType.DINERS_CLUB`. `cardNumber` - Spécifie le numéro de la carte de crédit en cours de validation.

	`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 ».

Valeur renvoyée

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

mx.validators.ValidationResult

Exemples Comment utiliser cet exemple

CreditCardValidatorExample.mxml

<?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>

Informations juridiques | Politique de confidentialité en ligne

CreditCardValidator - AS3 Flex

Packagesx

Eléments du langage

Annexes

Package mx.validators

allowedFormatChars

cardNumberListener

cardNumberProperty

cardNumberSource

cardTypeListener

cardTypeProperty

cardTypeSource

invalidCharError

invalidNumberError

noNumError

noTypeError

wrongLengthError

wrongTypeError