パッケージmx.validators
クラスpublic class PhoneNumberValidator
継承PhoneNumberValidator Inheritance Validator Inheritance EventDispatcher Inheritance Object

PhoneNumberValidator クラスでは、ストリングが電話番号として有効かどうかを検証します。 有効な電話番号には、少なくとも 10 桁の番号と、追加の書式文字が含まれます。 この検証では、電話番号が実在するかどうかはチェックされません。

MXML のシンタックスexpandedMXML シンタックスを隠す

The <mx:PhoneNumberValidator> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:PhoneNumberValidator 
    allowedFormatChars="()- .+" 
    invalidCharError="Your telephone number contains invalid characters."
    wrongLengthError="Your telephone number must contain at least 10 digits."
  />
  

例を表示



パブリックプロパティ
 プロパティ定義元
  allowedFormatChars : String
使用できる書式文字のセットを表します。
PhoneNumberValidator
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 Inheritedenabled : Boolean
この値を false に設定すると、バリデータによる検証が行えなくなります。
Validator
  invalidCharError : String
値に無効な文字が含まれている場合に発生するエラーメッセージを表します。
PhoneNumberValidator
 Inheritedlistener : Object
検証のリスナーを指定します。
Validator
 Inheritedproperty : String
検証する値を含む source オブジェクトのプロパティの名前を指定するストリングを表します。
Validator
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
 Inheritedrequired : Boolean = true
true の場合、検証エラーの原因となる欠損値または空値を指定します。
Validator
 InheritedrequiredFieldError : String
値が欠損し、required プロパティが true の場合に発生するエラーメッセージです。
Validator
 Inheritedsource : Object
検証するプロパティを含むオブジェクトを指定します。
Validator
 Inheritedtrigger : IEventDispatcher
バリデータをトリガするイベントの生成を行うコンポーネントを指定します。
Validator
 InheritedtriggerEvent : String
検証をトリガするイベントを指定します。
Validator
  wrongLengthError : String
値の桁数が 10 桁より少ない場合に発生するエラーメッセージを表します。
PhoneNumberValidator
プロテクトプロパティ
 プロパティ定義元
 InheritedactualListeners : Array
[読み取り専用] リスナーオブジェクトが存在する場合はリスナーオブジェクトを含みます。そうでない場合は、ソースオブジェクトを含みます。
Validator
 InheritedactualTrigger : IEventDispatcher
[読み取り専用] トリガオブジェクトが存在する場合はトリガオブジェクトを含みます。そうでない場合は、ソースオブジェクトを含みます。
Validator
 InheritedresourceManager : IResourceManager
[読み取り専用] アプリケーションのローカライズされたすべてのリソースを管理するオブジェクトへの参照です。
Validator
 InheritedsubFields : Array
validate() メソッドに渡された value オブジェクトに含まれるプロパティ名を含むストリングの配列です。
Validator
パブリックメソッド
 メソッド定義元
  
コンストラクタです。
PhoneNumberValidator
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
 Inherited
イベントをイベントフローに送出します。
EventDispatcher
 Inherited
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
MXML タグを使用してバリデータを作成したときに、MXML コンパイラによって自動的に呼び出されます。
Validator
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent
検証を実行し、リスナーに任意で結果を通知します。
Validator
 Inherited
validateAll(validators:Array):Array
[静的] validators 配列に含まれるすべてのバリデータを呼び出します。
Validator
  
[静的] カスタム検証関数からバリデータを呼び出す便利なメソッドです。
PhoneNumberValidator
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
プロテクトメソッド
 メソッド定義元
 Inherited
バリデータから送出された valid イベントおよび invalid イベントのすべてのリスナーを設定します。
Validator
  
[override] 電話番号を検証する上で基本クラスの doValidation() メソッドをオーバーライドします。
PhoneNumberValidator
 Inherited
検証するオブジェクトを返します。
Validator
 Inherited
エラー結果の配列から ValidationResultEvent を返します。
Validator
 Inherited
value が null でない場合、true を返します。
Validator
 Inherited
バリデータから送出された valid イベントおよび invalid イベントのすべてのリスナーを切断します。
Validator
 Inherited
このメソッドは、バリデータが作成されたときと、ResourceManager が "change" イベントを送出してローカライズされたリソースが何らかの点で変更されたことを示すときに再び呼び出されます。
Validator
イベント
 イベント 概要 定義元
 Inherited[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
 Inherited検証が失敗すると送出されます。Validator
 Inherited検証が正常に完了すると送出されます。Validator
プロテクト定数
 定数定義元
 InheritedDECIMAL_DIGITS : String = "0123456789"
[静的] 0 から 9 の 10 進数字を含むストリングです。
Validator
 InheritedROMAN_LETTERS : String = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"
[静的] ローマ字アルファベットの大文字と小文字を含む("A" から "Z"、および "a" から "z")ストリングです。
Validator
プロパティの詳細
allowedFormatCharsプロパティ
allowedFormatChars:String

使用できる書式文字のセットを表します。

デフォルト値 : "()- .+".



実装
    public function get allowedFormatChars():String
    public function set allowedFormatChars(value:String):void
invalidCharErrorプロパティ 
invalidCharError:String

値に無効な文字が含まれている場合に発生するエラーメッセージを表します。

デフォルト値 : 「電話番号に無効な文字が含まれています。」.



実装
    public function get invalidCharError():String
    public function set invalidCharError(value:String):void
wrongLengthErrorプロパティ 
wrongLengthError:String

値の桁数が 10 桁より少ない場合に発生するエラーメッセージを表します。

デフォルト値 : 「電話番号は最低 10 桁である必要があります。」.



実装
    public function get wrongLengthError():String
    public function set wrongLengthError(value:String):void
コンストラクタの詳細
PhoneNumberValidator()コンストラクタ
public function PhoneNumberValidator()

コンストラクタです。

メソッドの詳細
doValidation()メソッド
override protected function doValidation(value:Object):Array

電話番号を検証する上で基本クラスの doValidation() メソッドをオーバーライドします。

このメソッドは通常、ユーザーが直接呼び出すものではなく、妥当性を検証する際に Flex から呼び出されます。 Validator クラスをカスタムで作成する場合は、このメソッドを実装する必要があります。

パラメータ

value:Object — 検証するオブジェクトです。

戻り値
Array — ValidationResult オブジェクトの配列です。このオブジェクトは、検証が行われるフィールドごとに 1 つ含まれます。
validatePhoneNumber()メソッド 
public static function validatePhoneNumber(validator:PhoneNumberValidator, value:Object, baseField:String):Array

カスタム検証関数からバリデータを呼び出す便利なメソッドです。 他の標準 Flex バリデータにもそれぞれ同様の便利なメソッドがあります。

パラメータ

validator:PhoneNumberValidator — PhoneNumberValidator インスタンスを表します。
 
value:Object — 検証するフィールドを表します。
 
baseField:Stringvalue パラメータで指定したサブフィールドのテキスト表現です。 例えば、value パラメータで value.phone を指定する場合、baseField の値は "phone" です。

戻り値
Array — ValidationResult オブジェクトの配列です。このオブジェクトは、検証が行われるフィールドごとに 1 つ含まれます。

関連項目

例の使用法
PhoneNumberValidatorExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the PhoneNumberValidator. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

    <mx:Script>
        import mx.controls.Alert;
    </mx:Script>

    <mx:PhoneNumberValidator source="{phone}" property="text" 
        trigger="{myButton}" triggerEvent="click"
        valid="Alert.show('Validation Succeeded!');"/>

    <mx:Panel title="Phone Number Validator Panel" width="75%" height="75%" 
        paddingTop="10" paddingLeft="10" paddingRight="10" paddingBottom="10">

        <mx:Form>
            <mx:FormItem label="Enter 10-digit phone number: ">
                <mx:TextInput id="phone" width="100%"/>
            </mx:FormItem>

            <mx:FormItem >
                <mx:Button id="myButton" label="Validate" />
            </mx:FormItem>
        </mx:Form>
     </mx:Panel>
</mx:Application>




 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/mx/validators/PhoneNumberValidator.html