| Package | mx.validators |
| Classe | public class RegExpValidator |
| Héritage | RegExpValidator  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 |
expression et des indicateurs supplémentaires pour contrôler la correspondance du modèle de l’expression régulière à l’aide de la propriété flags.
La validation réussit si le programme de validation trouve une correspondance de l’expression régulière dans le champ à valider. Une erreur de validation se produit si le programme de validation ne trouve aucune correspondance.
La classe RegExpValidator distribue les événements valid et invalid. Pour un événement invalid, l’objet d’événement est une instance de la classe ValidationResultEvent et contient un tableau d’objets ValidationResult.
Cependant, pour un événement valid, l’objet ValidationResultEvent contient un tableau d’objets RegExpValidationResult. La classe RegExpValidationResult est une classe enfant de la classe ValidationResult et contient des propriétés supplémentaires utilisées avec les expressions régulières, y compris les propriétés suivantes :
-
matchedIndexNombre entier qui contient l’index de début dans la chaîne d’entrée de la correspondance. -
matchedStringChaîne qui contient la sous-chaîne de la chaîne d’entrée correspondant à l’expression régulière. -
matchedSubStringsTableau de chaînes qui contient des correspondances de sous-chaînes entre parenthèses, le cas échéant. Si aucune correspondance de sous-chaîne n’est trouvée, ce tableau comporte une longueur égale à 0. Utilisez matchedSubStrings[0] pour accéder à la première correspondance de sous-chaîne.
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <mx:RegExpValidator> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:RegExpValidator
expression="No default"
flags="No default"
noExpressionError="The expression is missing."
noMatchError="The field is invalid."
/>
Eléments de l’API associés
Propriétés publiques
| Propriété | Défini par | ||
|---|---|---|---|
 | 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 | |
| expression : String
Expression régulière à utiliser pour la validation. | RegExpValidator | ||
| flags : String
Indicateurs d’expressions régulières à utiliser lors de la mise en correspondance. | RegExpValidator | ||
| listener : Object
Spécifie l’écouteur de validation. | Validator | |
| noExpressionError : String
Message d’erreur si aucune expression régulière n’est spécifiée. | RegExpValidator | ||
| noMatchError : String
Message d’erreur s’il n’existe aucune correspondance de l’expression régulière. | RegExpValidator | ||
| 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 | |
Propriétés protégées
Méthodes publiques
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur
| RegExpValidator | ||
| 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 | |
|
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 une expression régulière. | RegExpValidator | ||
|
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é
expression | propriété |
flags | propriété |
flags:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indicateurs d’expressions régulières à utiliser lors de la mise en correspondance.
Implémentation
public function get flags():String public function set flags(value:String):voidnoExpressionError | propriété |
noExpressionError: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 aucune expression régulière n’est spécifiée. La valeur par défaut est « The expression is missing ».
Implémentation
public function get noExpressionError():String public function set noExpressionError(value:String):voidnoMatchError | propriété |
noMatchError: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 s’il n’existe aucune correspondance de l’expression régulière. La valeur par défaut est « The field is missing ».
Implémentation
public function get noMatchError():String public function set noMatchError(value:String):voidDétails du constructeur
RegExpValidator | () | Constructeur |
public function RegExpValidator()| 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 une expression régulière.
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 — Pour un résultat non valide, tableau d’objets ValidationResult, avec un objet ValidationResult pour chaque champ examiné par le programme de validation.
|
Exemples Comment utiliser cet exemple
RegExValidatorExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the RegExpValidator. -->
<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>
<![CDATA[
import mx.events.ValidationResultEvent;
import mx.validators.*;
// Write the results to the
private function handleResult(eventObj:ValidationResultEvent):void {
if (eventObj.type == ValidationResultEvent.VALID) {
// For valid events, the results Array contains
// RegExpValidationResult objects.
var xResult:RegExpValidationResult;
reResults.text = "";
for (var i:uint = 0; i < eventObj.results.length; i++) {
xResult = eventObj.results[i];
reResults.text=reResults.text + xResult.matchedIndex + " " + xResult.matchedString + "\n";
}
} else {
reResults.text = "";
}
}
]]>
</fx:Script>
<fx:Declarations>
<mx:RegExpValidator id="regExpV"
source="{regex_text}" property="text"
flags="g" expression="{regex.text}"
valid="handleResult(event)"
invalid="handleResult(event)"
trigger="{myButton}"
triggerEvent="click"/>
</fx:Declarations>
<s:Panel title="RegExpValidator Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<s:VGroup left="10" right="10" top="10" bottom="10">
<s:Label width="100%" text="Instructions:"/>
<s:Label width="100%" text="1. Enter text to search. By default, enter a string containing the letters ABC in sequence followed by any digit."/>
<s:Label width="100%" text="2. Enter the regular expression. By default, enter ABC\d."/>
<s:Label width="100%" text="3. Click the Button control to trigger the validation."/>
<s:Label width="100%" text="4. The results show the index in the text where the matching pattern begins, and the matching pattern. "/>
<mx:Form>
<mx:FormItem label="Enter text:">
<s:TextInput id="regex_text" text="xxxxABC4xxx" width="100%"/>
</mx:FormItem>
<mx:FormItem label="Enter regular expression:">
<s:TextInput id="regex" text="ABC\d" width="100%"/>
</mx:FormItem>
<mx:FormItem label="Results:">
<s:TextInput id="reResults" width="100%"/>
</mx:FormItem>
<mx:FormItem >
<s:Button id="myButton" label="Validate"/>
</mx:FormItem>
</mx:Form>
</s:VGroup>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 09:30 AM Z