ASDoc

mx.validators
StringValidator クラス

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

StringValidator クラスは、ストリングの長さが指定された範囲内であることを検証します。

MXML シンタックス

StringValidator クラスは、親クラスのプロパティと、次のプロパティを受け取ります。

 <mx:StringValidator
   minLength="minimum length - no default"
   maxLength="maximum length - no default"
   tooLongError="This string is longer than the maximum allowed length."
   tooShortError="This string is shorter than the minimum allowed length." 
 />

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

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

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

disable doValidation enable hasErrors isStructureValid isValid validateRequired validationError

プロパティ
	`maxLength:Number` 有効なストリングの最大の長さを表します。
	`minLength:Number` 有効なストリングの最小の長さを表します。
	`tooLongError:String` エラーメッセージを表します。
	`tooShortError:String`エラーメッセージを表します。

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

field listener required requiredFieldError validate

メソッドの詳細

doValidation

doValidation( value:Object)
										
													 :  Void

ストリングを検証します。

パラメータ
value:Object - 検証するストリングです。

validateString

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

プロパティの詳細

maxLength

maxLength:Number

有効なストリングの最大の長さを表します。デフォルトでは使用されません。

minLength

minLength:Number

有効なストリングの最小の長さを表します。デフォルトでは使用されません。

tooLongError

tooLongError:String

エラーメッセージを表します。デフォルト値は "This string is longer than the maximum allowed length." です。

tooShortError

tooShortError:String

エラーメッセージを表します。デフォルト値は "This string is shorter than the minimum allowed length." です。

例

StringValidatorExample.mxml

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

<mx:Model id="CheckModel">
<FirstName>{fname.text}</FirstName>
</mx:Model>

<mx:Panel title="String Validation Check Panel" backgroundColor="#0C8BF3">

<mx:Form color="#FFFFFF">
               
			    <mx:FormItem label="Enter name between 4 and 20 characters (required):" required="true" direction="horizontal">
<mx:TextInput id="fname" width="200" color="#000000"/>
</mx:FormItem>

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

<mx:StringValidator field="CheckModel.FirstName" tooShortError="This string is shorter than the minimum allowed length of 4. "
tooLongError="This string is longer than the maximum allowed length of 20." minLength="4" maxLength="20"/>

</mx:Application>