ASDoc

mx.validators
ZipCodeValidator クラス

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

ZipCodeValidator クラスは、ストリングが米国の郵便番号、ZIP+4 (標準プラス 4 桁) の郵便番号、またはカナダの郵便番号として正しい長さであることを検証します。

MXML シンタックス

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

 <mx:ZipCodeValidator
   allowedFormatChars=" -"
   domain="US Only | US or Canada "
   invalidCharError="The zip code contains invalid characters."
   invalidDomainError="The domain parameter is invalid.It must be either 'US Only' or 'US or Canada'."
   invalidFormatCharsError="The allowedFormatChars parameter is invalid.It cannot contain any digits or letters."
   wrongCAFormatError="The Canadian zip code must be formatted 'A1B 2C3'."
   wrongLengthError="The zip code must be 5 digits or 5+4 digits."
   wrongUSFormatError="The zip+4 extension must be formatted '12345-6789'." 
 />

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

メソッド
	`doValidation( value:Object) : Void`郵便番号を検証します。
`static`	`validateZipCode( 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`使用できる書式文字のセットを表します。
	`domain:String`チェックする郵便番号の種類を表します。
	`invalidCharError:String`エラーメッセージを表します。
	`invalidDomainError:String`エラーメッセージを表します。
	`invalidFormatCharsError:String`エラーメッセージを表します。
	`wrongCAFormatError:String`エラーメッセージを表します。
	`wrongLengthError:String`エラーメッセージを表します。
	`wrongUSFormatError:String`エラーメッセージを表します。

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

field listener required requiredFieldError validate

メソッドの詳細

doValidation

doValidation( value:Object)
										
													 :  Void

郵便番号を検証します。

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

validateZipCode

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

プロパティの詳細

allowedFormatChars

allowedFormatChars:String

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

domain

domain:String

チェックする郵便番号の種類を表します。有効な値は "US Only" および "US or Canada" です。デフォルト値は "US Only" です。

invalidCharError

invalidCharError:String

エラーメッセージを表します。デフォルト値は "The zip code contains invalid characters." です。

invalidDomainError

invalidDomainError:String

エラーメッセージを表します。デフォルト値は、"The domain parameter is invalid.It must be either 'US Only' or 'US or Canada'." です。

invalidFormatCharsError

invalidFormatCharsError:String

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

wrongCAFormatError

wrongCAFormatError:String

エラーメッセージを表します。デフォルト値は "The Canadian postal code must be formatted 'A1B 2C3'." です。

wrongLengthError

wrongLengthError:String

エラーメッセージを表します。デフォルト値は "The zip code must be 5 digits or 5+4 digits." です。

wrongUSFormatError

wrongUSFormatError:String

エラーメッセージを表します。デフォルト値は "The ZIP+4 code extension must be formatted '12345-6789'." です。

例

ZipCodeValidatorExample.mxml

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

<mx:Model id="CheckModel">
<Zip>{zip.text}</Zip>
</mx:Model>

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

<mx:VBox>

<mx:Form>

<mx:FormItem label="Enter 5 or 9 digit Zip code:" color="#FFFFFF">
<mx:TextInput id="zip" width="200" color="#000000"/>
</mx:FormItem>

</mx:Form>

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

</mx:VBox>

</mx:Panel>

<mx:ZipCodeValidator field="CheckModel.Zip"/>

</mx:Application>

mx.validators ZipCodeValidator クラス