ASDoc

mx.validators
EmailValidator クラス

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

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

MXML シンタックス

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

 <mx:EmailValidator
   invalidCharError="Invalid characters in your email address."
   invalidUsernameError="The email address must begin with a letter."
   invalidDomainError= "The domain in your email address is incorrectly formatted."
   invalidIPDomainError="The IP domain in your email address is incorrectly formatted."
   invalidPeriodsInDomainError="The domain in your email address has consecutive periods."
   missingAtSignError="Missing an at character in your email address."
   missingPeriodInDomainError="The domain in your email address is missing a period."
   missingUsernameError="The username in your email address is missing."
   tooManyAtSignsError="Too many at characters in your email address." 
 />

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

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

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

disable doValidation enable hasErrors isStructureValid isValid validateRequired validationError

プロパティ
	`invalidCharError:String` 無効な文字が電子メールアドレスに存在するときのエラーメッセージを表します。
	`invalidDomainError:String` 接尾辞 (最上位のドメイン) の長さが 2 文字、3 文字、4 文字または 6 文字ではないときのエラーメッセージを表します。
	`invalidIPDomainError:String` IP ドメインが無効なときのエラーメッセージを表します。
	`invalidPeriodsInDomainError:String` 連続するピリオドがドメインに存在するときのエラーメッセージを表します。
	`missingAtSignError:String` アットマークが電子メールアドレスに存在しないときのエラーメッセージを表します。
	`missingPeriodInDomainError:String` ピリオドがドメインに存在しないときのエラーメッセージを表します。
	`missingUsernameError:String` ユーザー名が存在しないときのエラーメッセージを表します。
	`tooManyAtSignsError:String` アットマークが電子メールアドレスに複数存在するときのエラーメッセージを表します。

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

field listener required requiredFieldError validate

メソッドの詳細

doValidation

doValidation( value:Object)
										
													 :  Void

電子メールアドレスを検証します。

パラメータ
value:Object - 電子メールアドレスを含むストリングを表します。

validateEmail

static  validateEmail( 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.email を指定する場合、baseField の値は "email" です。

プロパティの詳細

invalidCharError

invalidCharError:String

無効な文字が電子メールアドレスに存在するときのエラーメッセージを表します。デフォルト値は "Invalid characters in your email address." です。

invalidDomainError

invalidDomainError:String

接尾辞 (最上位のドメイン) の長さが 2 文字、3 文字、4 文字または 6 文字ではないときのエラーメッセージを表します。デフォルト値は "The domain in your email address is incorrectly formatted." です。

invalidIPDomainError

invalidIPDomainError:String

IP ドメインが無効なときのエラーメッセージを表します。デフォルト値は "The IP domain in your email address is incorrectly formatted." です。

invalidPeriodsInDomainError

invalidPeriodsInDomainError:String

連続するピリオドがドメインに存在するときのエラーメッセージを表します。デフォルト値は "The domain in your email address has continous periods." です。

missingAtSignError

missingAtSignError:String

アットマークが電子メールアドレスに存在しないときのエラーメッセージを表します。デフォルト値は "Missing an at character in your email address." です。

missingPeriodInDomainError

missingPeriodInDomainError:String

ピリオドがドメインに存在しないときのエラーメッセージを表します。デフォルト値は "The domain in your email address is missing a period." です。

missingUsernameError

missingUsernameError:String

ユーザー名が存在しないときのエラーメッセージを表します。デフォルト値は "The username in your email address is missing." です。

tooManyAtSignsError

tooManyAtSignsError:String

アットマークが電子メールアドレスに複数存在するときのエラーメッセージを表します。デフォルト値は "Too many at characters in your email address." です (オプション)。

例

EmailValidatorExample.mxml

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

<mx:Model id="CheckModel">
<Email>{email.text}</Email>
</mx:Model>

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

<mx:VBox>

<mx:Form>

<mx:FormItem label="E-mail address:" color="#FFFFFF">
<mx:TextInput id="email" width="200" color="#000000"/>
</mx:FormItem>

</mx:Form>

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

</mx:VBox>

</mx:Panel>

<mx:EmailValidator field="CheckModel.Email"/>

</mx:Application>

mx.validators EmailValidator クラス