Package | mx.formatters |
Class | public class PhoneFormatter |
Inheritance | PhoneFormatter ![]() ![]() |
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
A shortcut is provided for the United States seven-digit format.
If the areaCode
property contains a value
and you use the seven-digit format string, (###-####),
a seven-digit value to format automatically adds the area code
to the returned String.
The default format for the area code is (###).
You can change this using the areaCodeFormat
property.
You can format the area code any way you want as long as it contains
three number placeholders.
If an error occurs, an empty String is returned and a String
that describes the error is saved to the error
property.
The error
property can have one of the following values:
-
"Invalid value"
means an invalid numeric value is passed to theformat()
method. The value should be a valid number in the form of a Number or a String, or the value contains a different number of digits than what is specified in the format String. -
"Invalid format"
means any of the characters in theformatString
property do not match the allowed characters specified in thevalidPatternChars
property, or theareaCodeFormat
property is specified but does not contain exactly three numeric placeholders.

The <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="+()#-. " />
More examples
MX formatters
Writing an error handler function for an MX formatter
Formatting phone numbers with an MX formatter
Related API Elements
Property | Defined By | ||
---|---|---|---|
![]() | constructor : Object
A reference to the class object or constructor function for a given object instance. | Object |
Method | Defined By | ||
---|---|---|---|
![]() |
Indicates whether an object has a specified property defined. | Object | |
![]() |
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter. | Object | |
![]() |
Indicates whether the specified property exists and is enumerable. | Object | |
![]() |
Sets the availability of a dynamic property for loop operations. | Object | |
![]() |
Returns the string representation of this object, formatted according to locale-specific conventions. | Object | |
![]() |
Returns the string representation of the specified object. | Object | |
![]() |
Returns the primitive value of the specified object. | Object |
<?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>
Wed Nov 21 2018, 06:34 AM -08:00