| Package | mx.formatters |
| Classe | public class PhoneFormatter |
| Héritage | PhoneFormatter  Formatter Object |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Un raccourci est disponible pour le format à sept chiffres utilisé couramment aux Etats-Unis. Si la propriété areaCode contient une valeur et que vous utilisez la chaîne de format à sept chiffres (###-####), l’indicatif régional est ajouté automatiquement à la chaîne renvoyée lorsqu’une valeur à sept chiffres est formatée. Le format par défaut de l’indicatif régional est (###). Vous pouvez modifier ce format par le biais de la propriété areaCodeFormat. Vous pouvez formater l’indicatif régional de la manière que vous souhaitez, à condition qu’il contienne trois espaces réservés numériques.
Si une erreur se produit, une chaîne vide est renvoyée et une chaîne décrivant l’erreur est enregistrée dans la propriété error. La propriété error peut prendre l’une des valeurs suivantes :
-
"Invalid value"signifie qu’une valeur numérique non valide a été transmise à la méthodeformat(). La valeur doit être un nombre valide sous forme de nombre ou de chaîne, ou contenir un nombre de chiffres différent de celui spécifié dans la chaîne de format. -
"Invalid format"signifie qu’au moins un des caractères de la propriétéformatStringne correspond pas aux caractères autorisés spécifiés dans la propriétévalidPatternCharsou que la propriétéareaCodeFormata été spécifiée, mais qu’elle ne contient pas exactement trois espaces réservés numériques.
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <mx:PhoneFormatter> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:PhoneFormatter
areaCode="-1"
areaCodeFormat="(###)"
formatString="(###) ###-####"
validPatternChars="+()#-. "
/>
Eléments de l’API associés
| Propriété | Défini par | ||
|---|---|---|---|
| areaCode : Object
Indicatif régional ajouté à un numéro de téléphone à sept chiffres des Etats-Unis, afin de former un numéro de téléphone à dix chiffres. | PhoneFormatter | ||
| areaCodeFormat : String
Format par défaut de l’indicatif régional lorsque la propriété areacode est rendue par un format à sept chiffres. | PhoneFormatter | ||
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| error : String
Description enregistrée par la classe de formatage lorsqu’une erreur survient. | Formatter | |
| formatString : String
Chaîne contenant des caractères de modèle représentant un format de numéro de téléphone spécifié. | PhoneFormatter | ||
| validPatternChars : String
Liste des caractères valides pouvant être utilisés dans la propriété formatString. | PhoneFormatter | ||
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | PhoneFormatter | ||
[override]
Formate la chaîne sous forme de numéro de téléphone. | PhoneFormatter | ||
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
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 | |
|
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 | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
areaCode | propriété |
areaCode:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indicatif régional ajouté à un numéro de téléphone à sept chiffres des Etats-Unis, afin de former un numéro de téléphone à dix chiffres. La valeur -1 indique que l’indicatif régional ne doit pas être ajouté au début du numéro.
La valeur par défaut est -1.
Implémentation
public function get areaCode():Object public function set areaCode(value:Object):voidareaCodeFormat | propriété |
areaCodeFormat: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 par défaut de l’indicatif régional lorsque la propriété areacode est rendue par un format à sept chiffres.
La valeur par défaut est "(###) ".
Implémentation
public function get areaCodeFormat():String public function set areaCodeFormat(value:String):voidformatString | propriété |
formatString:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Chaîne contenant des caractères de modèle représentant un format de numéro de téléphone spécifié.
La valeur par défaut est "(###) ###-####".
Implémentation
public function get formatString():String public function set formatString(value:String):voidvalidPatternChars | propriété |
validPatternChars:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Liste des caractères valides pouvant être utilisés dans la propriété formatString. Cette propriété est utilisée lors de la validation de la propriété formatString.
La valeur par défaut est "+()#- .".
Implémentation
public function get validPatternChars():String public function set validPatternChars(value:String):voidPhoneFormatter | () | Constructeur |
public function PhoneFormatter()| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
format | () | méthode |
override public function format(value:Object):String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Formate la chaîne sous forme de numéro de téléphone. S’il est impossible de formater la valeur, une chaîne vide est renvoyée et une description de l’erreur est écrite dans la propriété error.
Paramètres
value:Object — Valeur à formater.
|
String — Chaîne formatée. Vide si une erreur se produit. Une description de la condition d’erreur est écrite dans la propriété error.
|
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate PhoneFormatter. -->
<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;
private var vResult:ValidationResultEvent;
// Event handler to validate and format input.
private function Format():void {
vResult = pnVal.validate();
if (vResult.type == ValidationResultEvent.VALID) {
formattedPhone.text = phoneFormatter.format(phone.text);
} else {
formattedPhone.text = "";
}
}
]]>
</fx:Script>
<fx:Declarations>
<mx:PhoneFormatter id="phoneFormatter"
formatString="(###) ###-####" validPatternChars="#-() "/>
<mx:PhoneNumberValidator id="pnVal" source="{phone}" property="text"
allowedFormatChars=""/>
</fx:Declarations>
<s:Panel title="PhoneFormatter Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<mx:Form left="10" right="10" top="10" bottom="10">
<mx:FormItem label="Enter a 10-digit phone number:">
<s:TextInput id="phone" text="" width="75%"/>
</mx:FormItem>
<mx:FormItem label="Formatted phone number: ">
<s:TextInput id="formattedPhone" text="" width="75%" editable="false"/>
</mx:FormItem>
<mx:FormItem>
<s:Button label="Validate and Format" click="Format();"/>
</mx:FormItem>
</mx:Form>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 09:30 AM Z