ASDoc

mx.validators
PhoneNumberValidator クラス

PhoneNumberValidator クラス
mx.validators.Validator の拡張

PhoneNumberValidator クラスは、ストリングが有効な電話番号であることを検証します。この検証では、電話番号が実在するかどうかはチェックされません。

MXML シンタックス

<mx:PhoneNumberValidator> タグは、親クラスのプロパティと、次のプロパティを受け取ります。

 <mx:PhoneNumberValidator
   allowedFormatChars="()- .+"
   invalidCharError="Invalid characters in your phone number."
   invalidFormatCharsError="The allowedFormatChars parameter is invalid.It can not contain any digits."
   wrongLengthError="Your telephone number must be at least 10 digits in length." 
 />

例を参照するにはここをクリックしてください

メソッド
	`doValidation( value:Object) : Void` 電話番号を検証します。
`static`	`validatePhoneNumber( validator:mx.validators.Validator, value:Object, paramObj:Object, baseField:String) : Boolean` <mx:Validator> タグを使用する場合に、カスタム検証関数からバリデータを呼び出す便利なメソッドです。

mx.validators.Validator クラスから継承されるメソッド

disable doValidation enable hasErrors isStructureValid isValid validateRequired validationError

プロパティ
	`allowedFormatChars:String`使用できる書式文字のセットを表します。
	`invalidCharError:String`エラーメッセージを表します。
	`invalidFormatCharsError:String`エラーメッセージを表します。
	`wrongLengthError:String`エラーメッセージを表します。

mx.validators.Validator クラスから継承されるプロパティ

field listener required requiredFieldError validate

メソッドの詳細

doValidation

doValidation( value:Object)
										
													 :  Void

電話番号を検証します。

パラメータ
value:Object - 電話番号を含むストリングを表します。

validatePhoneNumber

static  validatePhoneNumber( validator:mx.validators.Validator, value:Object, paramObj:Object, baseField:String)
										
													 :  Boolean

<mx:Validator> タグを使用する場合に、カスタム検証関数からバリデータを呼び出す便利なメソッドです。他の標準バリデータにもそれぞれ同様の便利なメソッドがあります。

パラメータ
    validator:mx.validators.Validator - Validator インスタンスです。
    value:Object - value.subfield。タグの field プロパティで指定された値のサブフィールドを subfield として指定します。
    paramObj:Object - パラメータ情報 (エラーメッセージ、最小値と最大値など) を含んだオブジェクトを指定します。このパラメータはオプションですが、baseField を指定する場合には、null を指定します。
    baseField:String - value パラメータで指定した subfield のテキスト表現を指定します。たとえば、value パラメータで value.phone を指定する場合、baseField の値は "phone" です。

プロパティの詳細

allowedFormatChars

allowedFormatChars:String

使用できる書式文字のセットを表します。デフォルト値は "()- .+" です。

invalidCharError

invalidCharError:String

エラーメッセージを表します。デフォルト値は "Invalid characters in your phone number." です。

invalidFormatCharsError

invalidFormatCharsError:String

エラーメッセージを表します。デフォルト値は、"The allowedFormatChars parameter is invalid.It can not contain any digits." です。

wrongLengthError

wrongLengthError:String

エラーメッセージを表します。デフォルト値は "Your telephone number must be at least 10 digits in length." です。

例

PhoneNumberValidatorExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- PhoneNumber バリデータの使用方法を示す簡単な例 -->
<mx:Application xmlns:mx="http://www.macromedia.com/2003/mxml" backgroundColor="#FFFFFF">

<mx:Model id="CheckModel">
<Phone>{phone.text}</Phone>
</mx:Model>

<mx:Panel title="Phone Number Validator Panel" backgroundColor="#0C8BF3">

<mx:Form>
<mx:FormItem label="Enter 10-digit Phone no:" color="#FFFFFF">
<mx:TextInput id="phone" width="200"/>
</mx:FormItem>
</mx:Form>

<mx:Label text="*press enter to check validation." color="#FFCCCC"/>

</mx:Panel>

<mx:PhoneNumberValidator field="CheckModel.Phone"/>

</mx:Application>