| パッケージ | mx.formatters |
| public class PhoneFormatter | |
| 継承 | PhoneFormatter Formatter Object |
7 桁の米国形式の電話番号については、ショートカットが用意されています。areaCode プロパティに値が含まれ、7 桁の形式のストリング (###-####) を使用した場合、返されるストリングに自動的に市外局番が追加されます。エリアコードのデフォルトの形式は、(###) です。この形式は areaCodeFormat プロパティを使用して変更できます。エリアコードは、3 桁のプレースホルダーを使用する限り任意に設定できます。
エラーが発生すると、空のストリングが返され、エラーを説明するストリングが error プロパティに保存されます。この error プロパティに指定できる値は、次のうちのいずれかです。
"Invalid value" は、無効な数値が format() メソッドに渡されたことを示します。値は Number 型または String 型の有効な値にする必要があります。または、値の桁数が、フォーマットストリングで指定された桁数と異なっています。"Invalid format" は、formatString プロパティの任意の文字が validPatternChars プロパティで指定されている文字と一致しない、または areaCodeFormat プロパティが指定されているのに対して、数値プレースホルダーの数が 3 ではないことを示します。
MXML シンタックスの非表示
<mx:PhoneFormatter> タグは、スーパークラスのすべてのタグ属性を継承し、次のタグ属性を追加します。
<mx:PhoneFormatter areaCode "-1" areaCodeFormat "(###)" formatString="(###) ###-####" validPatternChars "+()#-。" />
関連項目
| プロパティ | 定義 | ||
|---|---|---|---|
| areaCode : int
10 桁の電話番号を構成するために米国形式の 7 桁の電話番号に追加される市外局番 (エリアコード) を表します。
| PhoneFormatter | ||
areaCodeFormat : String
areacode プロパティが 7 桁形式で表示された場合に使用される、市外局番のデフォルトの形式です。 | PhoneFormatter | ||
![]() | constructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
| Object | |
![]() | error : String
エラーが発生したときにフォーマッタによって保存される説明を表します。
| Formatter | |
| formatString : String
指定の電話番号のフォーマットを示すマスク文字を含むストリングを表します。
| PhoneFormatter | ||
![]() | prototype : Object
[static]
クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
| Object | |
validPatternChars : String
formatString プロパティで使用できる有効な文字のリストを表します。 | PhoneFormatter | ||
| メソッド | 定義 | ||
|---|---|---|---|
| PhoneFormatter()
コンストラクタ。
| PhoneFormatter | ||
| format(value:Object):String
ストリングを電話番号としてフォーマットします。
| PhoneFormatter | ||
![]() | hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
| Object | |
![]() | isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
| Object | |
![]() | propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙可能かどうかを示します。
| Object | |
![]() | setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
| Object | |
![]() | toString():String
指定されたオブジェクトのストリング表現を返します。
| Object | |
![]() | valueOf():Object
指定されたオブジェクトのプリミティブ値を返します。
| Object | |
| areaCode | プロパティ |
public var areaCode:int
10 桁の電話番号を構成するために米国形式の 7 桁の電話番号に追加される市外局番 (エリアコード) を表します。値が -1 の場合、前に市外局番を追加しません。
デフォルト値-1.
| areaCodeFormat | プロパティ |
public var areaCodeFormat:String
areacode プロパティが 7 桁形式で表示された場合に使用される、市外局番のデフォルトの形式です。
デフォルト値"(###) ".
| formatString | プロパティ |
| validPatternChars | プロパティ |
public var validPatternChars:String
formatString プロパティで使用できる有効な文字のリストを表します。このプロパティは、formatString プロパティの検証に使用されます。
デフォルト値"+()#- .".
| PhoneFormatter | () | コンストラクタ |
public 関数 PhoneFormatter()コンストラクタ。
| format | () | メソッド |
public override function format(value:Object):String
ストリングを電話番号としてフォーマットします。値をフォーマットできない場合、空のストリングが返され、error プロパティにエラーの説明が書き込まれます。
value:Object — フォーマットする値を表します。
|
String —
フォーマットしたストリングを表します。エラーが発生した場合は空です。エラーの状態を示す説明が error プロパティに書き込まれます。
|
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate PhoneFormatter. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
<mx: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= "";
}
}
]]>
</mx:Script>
<mx:PhoneFormatter id="phoneFormatter"
formatString="(###) ###-####" validPatternChars="#-() "/>
<mx:PhoneNumberValidator id="pnVal" source="{phone}" property="text"
allowedFormatChars=""/>
<mx:Panel title="PhoneFormatter Example" width="75%" height="75%"
paddingTop="10" paddingLeft="10" paddingRight="10" paddingBottom="10">
<mx:Form>
<mx:FormItem label="Enter a 10-digit phone number:">
<mx:TextInput id="phone" text="" width="75%"/>
</mx:FormItem>
<mx:FormItem label="Formatted phone number: ">
<mx:TextInput id="formattedPhone" text="" width="75%" editable="false"/>
</mx:FormItem>
<mx:FormItem>
<mx:Button label="Validate and Format" click="Format();"/>
</mx:FormItem>
</mx:Form>
</mx:Panel>
</mx:Application>
このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート
現在のページ: http://livedocs.adobe.com/flex/2_jp/langref/mx/formatters/PhoneFormatter.html