DateValidator

Package	mx.validators
Classe	public class DateValidator
Héritage	DateValidator 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 DateValidator valide le fait qu’une chaîne, qu’une date ou qu’un objet contient une date correcte correspondant à un format spécifié. Les utilisateurs peuvent entrer un seul chiffre ou deux chiffres pour le mois, le jour et l’année. Par défaut, le programme de validation assure les formats suivants :

Le mois est compris entre 1 et 12 (ou 0-11 pour les objets Date).
Le jour est compris entre 1 et 31.
L’année est un nombre.

Vous pouvez spécifier la date dans la classe DateValidator de deux manières :

Une seule classe String contenant la date - Utilisez les propriétés source et property pour spécifier la classe String. La classe Chaîne peut contenir des chiffres et les caractères de formatage spécifiés par la propriété allowedFormatChars, qui incluent les caractères "/\-.". Par défaut, le format d’entrée de la date dans un champ String est « MM/DD/YYYY », « MM » correspondant au mois, « DD » au jour et « YYYY » à l’année. Vous pouvez utiliser la propriété inputFormat pour spécifier un format différent.
Objet Date.
Champs Object ou champs multiples contenant le jour, le mois et l’année. Utilisez l’ensemble des propriétés suivantes pour spécifier le jour, le mois et l’année : daySource, dayProperty, monthSource, monthProperty, yearSource et yearProperty.

Syntaxe MXML expanded

Masquer la syntaxe MXML

The <mx:DateValidator> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:DateValidator 
    allowedFormatChars="/\-. " 
    dayListener="Object specified by daySource"
    dayProperty="No default"
    daySource="No default"
    formatError= "Configuration error: Incorrect formatting string." 
    inputFormat="MM/DD/YYYY" 
    invalidCharError="The date contains invalid characters."
    monthListener="Object specified by monthSource"
    monthProperty="No default"
    monthSource="No default"
    validateAsString="true|false"
    wrongDayError="Enter a valid day for the month."
    wrongLengthError="Type the date in the format inputFormat." 
    wrongMonthError="Enter a month between 1 and 12."
    wrongYearError="Enter a year between 0 and 9999."
    yearListener="Object specified by yearSource"
    yearProperty="No default"
    yearSource="No default"
  />

Consulter les exemples

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 pour séparer les valeurs month, day et year.	DateValidator
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		dayListener : IValidatorListener Composant qui écoute le résultat de validation pour le sous-champ day.	DateValidator
		dayProperty : String Nom de la propriété day à valider.	DateValidator
		daySource : Object Objet contenant la valeur du champ day.	DateValidator
		enabled : Boolean Si cette valeur est définie sur false, le programme de validation arrête la validation.	Validator
		formatError : String Message d’erreur si le format de la propriété inputFormat n’est pas correct.	DateValidator
		inputFormat : String Format de date par rapport auquel valider la valeur.	DateValidator
		invalidCharError : String Message d’erreur lorsque la date contient des caractères non valides.	DateValidator
		listener : Object Spécifie l’écouteur de validation.	Validator
		monthListener : IValidatorListener Composant qui écoute le résultat de validation pour le sous-champ month.	DateValidator
		monthProperty : String Nom de la propriété month à valider.	DateValidator
		monthSource : Object Objet contenant la valeur du champ month.	DateValidator
		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
		validateAsString : Object Détermine comment valider la valeur.	DateValidator
		wrongDayError : String Message d’erreur lorsque le jour n’est pas valide.	DateValidator
		wrongLengthError : String Message d’erreur lorsque la longueur de la date ne correspond pas à celle spécifiée par la propriété inputFormat.	DateValidator
		wrongMonthError : String Message d’erreur lorsque le mois n’est pas valide.	DateValidator
		wrongYearError : String Message d’erreur lorsque l’année n’est pas valide.	DateValidator
		yearListener : IValidatorListener Composant qui écoute le résultat de validation pour le sous-champ année.	DateValidator
		yearProperty : String Nom de la propriété year à valider.	DateValidator
		yearSource : Object Objet contenant la valeur du champ year.	DateValidator

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
		DateValidator() Constructeur.	DateValidator
		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
		validateDate(validator:DateValidator, value:Object, baseField:String):Array [statique] Méthode pratique pour appeler une classe Validator dans une fonction de validation personnalisée.	DateValidator
		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 une date.	DateValidator
		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é

Détails du constructeur

Détails de la méthode

Exemples Comment utiliser cet exemple

DateValidatorExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the DateValidator. -->
<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>
        <fx:Model id="CheckModel">
            <dateInfo>
                <DOB>{dob.text}</DOB>
            </dateInfo>
        </fx:Model>

        <mx:DateValidator source="{dob}" property="text" allowedFormatChars="/" 
                trigger="{myButton}" triggerEvent="click" 
                valid="Alert.show('Validation Succeeded!');"/>
    </fx:Declarations>

    <s:Panel title="DateValidator Example"
            width="75%" height="75%" 
            horizontalCenter="0" verticalCenter="0">
        <mx:Form left="10" right="10" top="10" bottom="10">
            <mx:FormItem label="Enter date of birth (mm/dd/yyyy): ">
                <s:TextInput id="dob" width="100%"/>
            </mx:FormItem>
            <mx:FormItem >
                <s:Button id="myButton" label="Validate" />
            </mx:FormItem>
        </mx:Form>
    </s:Panel>

</s:Application>

Informations juridiques | Politique de confidentialité en ligne

DateValidator - AS3 Flex

Packagesx

Eléments du langage

Annexes

Package mx.validators

allowedFormatChars

dayListener

dayProperty

daySource

formatError

inputFormat

invalidCharError

monthListener

monthProperty

monthSource

validateAsString

wrongDayError

wrongLengthError

wrongMonthError

wrongYearError

yearListener

yearProperty

yearSource

doValidation

validateDate

	`validator:DateValidator` — Instance DateValidator.

	`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.date, la valeur `baseField` est « date ».