| 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 |
- 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
sourceetpropertypour 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éinputFormatpour 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,yearSourceetyearProperty.
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <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"
/>
| 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 | ||
| Méthode | Défini par | ||
|---|---|---|---|
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 | |
|
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. | DateValidator | ||
|
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 une date. | DateValidator | ||
|
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 pour séparer les valeurs month, day et year.
La valeur par défaut est "/\-. ".
Implémentation
public function get allowedFormatChars():String public function set allowedFormatChars(value:String):voiddayListener | propriété |
dayListener: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 day. Si aucune valeur n’est spécifiée, utilisez la valeur spécifiée pour la propriété daySource.
Implémentation
public function get dayListener():IValidatorListener public function set dayListener(value:IValidatorListener):voiddayProperty | propriété |
public var dayProperty: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é day à valider. Cette propriété est facultative, mais si vous spécifiez la propriété daySource, définissez également cette propriété.
daySource | propriété |
daySource: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 day. Si vous spécifiez une valeur pour cette propriété, vous devez aussi en spécifier une pour la propriété dayProperty. N’utilisez pas cette propriété si vous définissez les propriétés source et property.
Implémentation
public function get daySource():Object public function set daySource(value:Object):voidformatError | propriété |
formatError: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 si le format de la propriété inputFormat n’est pas correct.
La valeur par défaut est "Configuration error: Incorrect formatting string.".
Implémentation
public function get formatError():String public function set formatError(value:String):voidinputFormat | propriété |
inputFormat:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Format de date par rapport auquel valider la valeur. « MM » correspond au mois, « DD » au jour et « YYYY » à l’année. Cette chaîne est sensible à la casse.
La valeur par défaut est "MM/DD/YYYY".
Implémentation
public function get inputFormat():String public function set inputFormat(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 la date contient des caractères non valides.
La valeur par défaut est "Invalid characters in your date.".
Implémentation
public function get invalidCharError():String public function set invalidCharError(value:String):voidmonthListener | propriété |
monthListener: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 month. Si aucune valeur n’est spécifiée, utilisez la valeur spécifiée pour la propriété monthSource.
Implémentation
public function get monthListener():IValidatorListener public function set monthListener(value:IValidatorListener):voidmonthProperty | propriété |
public var monthProperty: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é month à valider. Cette propriété est facultative, mais si vous spécifiez la propriété monthSource, définissez également cette propriété.
monthSource | propriété |
monthSource: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 month. Si vous spécifiez une valeur pour cette propriété, vous devez aussi en spécifier une pour la propriété monthProperty. N’utilisez pas cette propriété si vous définissez les propriétés source et property.
Implémentation
public function get monthSource():Object public function set monthSource(value:Object):voidvalidateAsString | propriété |
validateAsString:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Détermine comment valider la valeur. Si défini sur true, le programme de validation évalue la valeur en tant qu’objet String, sauf si elle comporte une propriété month, day ou year. Si false, le programme de validation évalue la valeur en tant qu’objet Date.
La valeur par défaut est true.
Implémentation
public function get validateAsString():Object public function set validateAsString(value:Object):voidwrongDayError | propriété |
wrongDayError: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 jour n’est pas valide.
La valeur par défaut est "Enter a valid day for the month.".
Implémentation
public function get wrongDayError():String public function set wrongDayError(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 la longueur de la date ne correspond pas à celle spécifiée par la propriété inputFormat.
La valeur par défaut est "Type the date in the format inputFormat.".
Implémentation
public function get wrongLengthError():String public function set wrongLengthError(value:String):voidwrongMonthError | propriété |
wrongMonthError: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 mois n’est pas valide.
La valeur par défaut est "Enter a month between 1 and 12.".
Implémentation
public function get wrongMonthError():String public function set wrongMonthError(value:String):voidwrongYearError | propriété |
wrongYearError: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’année n’est pas valide.
La valeur par défaut est "Enter a year between 0 and 9999.".
Implémentation
public function get wrongYearError():String public function set wrongYearError(value:String):voidyearListener | propriété |
yearListener: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 année. Si aucune valeur n’est spécifiée, utilisez la valeur spécifiée pour la propriété yearSource.
Implémentation
public function get yearListener():IValidatorListener public function set yearListener(value:IValidatorListener):voidyearProperty | propriété |
public var yearProperty: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é year à valider. Cette propriété est facultative, mais si vous spécifiez la propriété yearSource, définissez également cette propriété.
yearSource | propriété |
yearSource: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 year. Si vous spécifiez une valeur pour cette propriété, vous devez aussi en spécifier une pour la propriété yearProperty. N’utilisez pas cette propriété si vous définissez les propriétés source et property.
Implémentation
public function get yearSource():Object public function set yearSource(value:Object):voidDateValidator | () | Constructeur |
public function DateValidator()| 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 une date.
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.
|
validateDate | () | méthode |
public static function validateDate(validator:DateValidator, 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: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 ».
|
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 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>
Tue Jun 12 2018, 09:30 AM Z