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

EmailValidator クラスは、ストリングに 1 つのアットマーク（@）があり、ドメイン名に 1 つのピリオドが含まれ、最上位のドメインの接尾辞は 2 文字、3 文字、4 文字、または 6 文字からなることを検証します。 IP ドメイン名は、角括弧に囲まれていれば有効です。 この検証では、ドメインとユーザー名が実在するかどうかはチェックされません。

IP ドメイン名も、角括弧で囲めば使用できます（例:myname@[206.132.22.1]）。 0 ～ 255 の範囲の IP 番号を使用できます。

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

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

  <mx:EmailValidator 
    invalidCharError="Your e-mail address contains invalid characters."
    invalidDomainError= "The domain in your e-mail address is incorrectly formatted." 
    invalidIPDomainError="The IP domain in your e-mail address is incorrectly formatted." 
    invalidPeriodsInDomainError="The domain in your e-mail address has consecutive periods." 
    missingAtSignError="An at sign (&64;) is missing in your e-mail address."
    missingPeriodInDomainError="The domain in your e-mail address is missing a period." 
    missingUsernameError="The username in your e-mail address is missing." 
    tooManyAtSignsError="Your e-mail address contains too many &64; characters."
  />

例を表示


パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 Inheritedenabled : Boolean
この値を false に設定すると、バリデータによる検証が行えなくなります。
Validator
  invalidCharError : String
無効な文字が電子メールアドレスに存在するときのエラーメッセージを表します。
EmailValidator
  invalidDomainError : String
接尾辞（最上位のドメイン）の長さが 2 文字、3 文字、4 文字または 6 文字ではないときのエラーメッセージを表します。
EmailValidator
  invalidIPDomainError : String
IP ドメインが無効なときのエラーメッセージを表します。
EmailValidator
  invalidPeriodsInDomainError : String
連続するピリオドがドメインに存在するときのエラーメッセージを表します。
EmailValidator
 Inheritedlistener : Object
検証のリスナーを指定します。
Validator
  missingAtSignError : String
アットマークが電子メールアドレスに存在しないときのエラーメッセージを表します。
EmailValidator
  missingPeriodInDomainError : String
ピリオドがドメインに存在しないときのエラーメッセージを表します。
EmailValidator
  missingUsernameError : String
ユーザー名が存在しないときのエラーメッセージを表します。
EmailValidator
 Inheritedproperty : String
検証する値を含む source オブジェクトのプロパティの名前を指定するストリングを表します。
Validator
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
 Inheritedrequired : Boolean = true
true の場合、検証エラーの原因となる欠損値または空値を指定します。
Validator
 InheritedrequiredFieldError : String
値が欠損し、required プロパティが true の場合に発生するエラーメッセージです。
Validator
 Inheritedsource : Object
検証するプロパティを含むオブジェクトを指定します。
Validator
  tooManyAtSignsError : String
アットマークが電子メールアドレスに複数存在するときのエラーメッセージを表します。
EmailValidator
 Inheritedtrigger : IEventDispatcher
バリデータをトリガするイベントの生成を行うコンポーネントを指定します。
Validator
 InheritedtriggerEvent : String
検証をトリガするイベントを指定します。
Validator
プロテクトプロパティ
 プロパティ定義元
 InheritedactualListeners : Array
[読み取り専用] リスナーオブジェクトが存在する場合はリスナーオブジェクトを含みます。そうでない場合は、ソースオブジェクトを含みます。
Validator
 InheritedactualTrigger : IEventDispatcher
[読み取り専用] トリガオブジェクトが存在する場合はトリガオブジェクトを含みます。そうでない場合は、ソースオブジェクトを含みます。
Validator
 InheritedresourceManager : IResourceManager
[読み取り専用] アプリケーションのローカライズされたすべてのリソースを管理するオブジェクトへの参照です。
Validator
 InheritedsubFields : Array
validate() メソッドに渡された value オブジェクトに含まれるプロパティ名を含むストリングの配列です。
Validator
パブリックメソッド
 メソッド定義元
  
EmailValidator()
コンストラクタです。
EmailValidator
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
 Inherited
dispatchEvent(event:Event):Boolean
イベントをイベントフローに送出します。
EventDispatcher
 Inherited
hasEventListener(type:String):Boolean
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
initialized(document:Object, id:String):void
MXML タグを使用してバリデータを作成したときに、MXML コンパイラによって自動的に呼び出されます。
Validator
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
toString():String
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent
検証を実行し、リスナーに任意で結果を通知します。
Validator
 Inherited
validateAll(validators:Array):Array
[静的] validators 配列に含まれるすべてのバリデータを呼び出します。
Validator
  
validateEmail(validator:EmailValidator, value:Object, baseField:String):Array
[静的] カスタム検証関数からバリデータを呼び出す便利なメソッドです。
EmailValidator
 Inherited
valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
willTrigger(type:String):Boolean
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
プロテクトメソッド
 メソッド定義元
 Inherited
addListenerHandler():void
バリデータから送出された valid イベントおよび invalid イベントのすべてのリスナーを設定します。
Validator
  
doValidation(value:Object):Array
[override] 電子メールアドレスの妥当性を検証する上で基本クラスの doValidation() メソッドをオーバーライドします。
EmailValidator
 Inherited
getValueFromSource():Object
検証するオブジェクトを返します。
Validator
 Inherited
handleResults(errorResults:Array):ValidationResultEvent
エラー結果の配列から ValidationResultEvent を返します。
Validator
 Inherited
isRealValue(value:Object):Boolean
value が null でない場合、true を返します。
Validator
 Inherited
removeListenerHandler():void
バリデータから送出された valid イベントおよび invalid イベントのすべてのリスナーを切断します。
Validator
 Inherited
resourcesChanged():void
このメソッドは、バリデータが作成されたときと、ResourceManager が "change" イベントを送出してローカライズされたリソースが何らかの点で変更されたことを示すときに再び呼び出されます。
Validator
イベント
 イベント 概要 定義元
 Inherited
activate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited
deactivate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
 Inherited
invalid
検証が失敗すると送出されます。Validator
 Inherited
valid
検証が正常に完了すると送出されます。Validator
プロテクト定数
 定数定義元
 InheritedDECIMAL_DIGITS : String = "0123456789"
[静的] 0 から 9 の 10 進数字を含むストリングです。
Validator
 InheritedROMAN_LETTERS : String = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"
[静的] ローマ字アルファベットの大文字と小文字を含む（"A" から "Z"、および "a" から "z"）ストリングです。
Validator
プロパティの詳細
invalidCharErrorプロパティ
invalidCharError:String

無効な文字が電子メールアドレスに存在するときのエラーメッセージを表します。

デフォルト値 : 「電子メールアドレスに無効な文字が含まれています。」.



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

接尾辞（最上位のドメイン）の長さが 2 文字、3 文字、4 文字または 6 文字ではないときのエラーメッセージを表します。

デフォルト値 : 「電子メールアドレスのドメインの形式が正しくありません。」.



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

IP ドメインが無効なときのエラーメッセージを表します。 IP ドメインは角括弧で囲む必要があります。

デフォルト値 : 「電子メールアドレスの IP ドメインの形式が正しくありません。」.



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

連続するピリオドがドメインに存在するときのエラーメッセージを表します。

デフォルト値 : 「電子メールアドレスのドメインに連続するピリオドが含まれています。」.



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

アットマークが電子メールアドレスに存在しないときのエラーメッセージを表します。

デフォルト値 : 「電子メールアドレスにアットマーク（&64;）がありません。」.



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

ピリオドがドメインに存在しないときのエラーメッセージを表します。

デフォルト値 : 「電子メールアドレスのドメインにピリオドがありません。」.



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

ユーザー名が存在しないときのエラーメッセージを表します。

デフォルト値 : 「電子メールアドレスにユーザー名がありません。」.



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

アットマークが電子メールアドレスに複数存在するときのエラーメッセージを表します。 このプロパティはオプションです。

デフォルト値 : 「電子メールアドレスに含まれている &64; が多すぎます。」.



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

コンストラクタです。

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

電子メールアドレスの妥当性を検証する上で基本クラスの doValidation() メソッドをオーバーライドします。

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

パラメータ

value:Object — 検証するストリングまたはオブジェクトのいずれかとなります。

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

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

パラメータ

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

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

関連項目

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

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

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

   <mx:Panel title="EmailValidator Example" width="75%" height="75%" 
        paddingTop="10" paddingLeft="10" paddingRight="10" paddingBottom="10">

        <mx:Form>
            <mx:FormItem label="Enter an e-mail address: ">
                <mx:TextInput id="email" width="100%"/>
            </mx:FormItem>

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



© 2009 Adobe Systems Incorporated. All rights reserved.
Thu Mar 19 2009, 08:51 PM -07:00
 

 

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

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