Spry

検査の種類とフォーマットの指定

テキストフィールド検査 Widget では、さまざまな検査の種類、フォーマット、およびその他のオプションを指定できます。 たとえば、クレジットカード番号を入力するテキストフィールドにはクレジットカード検査を指定できます。

検査の種類、フォーマット、およびその他のオプションは、Widget コンストラクタのパラメータとして指定します。 コンストラクタの最初のパラメータは Widget コンテナ ID です。その後に検査の種類を 2 番目のパラメータとして指定し、さらにオプションで 3 番目のパラメータを指定します。 3 番目のパラメータは、2 番目のパラメータで設定した検査の種類に依存するオプションの JavaScript 配列です。 したがって、2 番目のパラメータを設定しない場合、3 番目のパラメータは設定できません。

注意: 検査の種類が不要の場合に 3 番目のパラメータを設定するには、検査の種類を "none" に設定できます。

次のコードは、テキストフィールド Widget コンストラクタにさまざまなパラメータを指定するための一般的な構文を示しています。

<script type="text/javascript">
	var sprytextfield1= new Spry.Widget.ValidationTextField("WidgetContainerID", "ValidationType", {option1:"value1", option2:"value2", ..});
</script>

検査の種類のオプション

ほとんどの検査では、検査が行われるために標準のフォーマットが必要になります。 たとえばテキストフィールドに整数検査を適用した場合は、テキストフィールドに数字が入力されない限り検査は行われません。 ただし検査の種類によっては、テキストフィールドに入力できるフォーマットの種類を選択できます。

次の表は、使用できる検査の種類とそのフォーマットのリストです。

検査の種類

フォーマット

none

特別なフォーマットは不要です。

integer

数字のみを入力できます。

email

@ 記号およびピリオド (.) を含み、ピリオドの前後に 1 文字以上の文字がある 電子メールアドレスのみを入力できます。

date

フォーマットはさまざまです。

time

フォーマットはさまざまです。

credit_card

フォーマットはさまざまです。

zip_code

フォーマットはさまざまです。

phone_number

米国またはカナダの (000) 000-0000 フォーマット、またはカスタムフォーマットで入力できます。

social_security_number

デフォルトでは、社会保証番号を 000-00-0000 のフォーマットで入力できます。

currency

1,000,000.00 または 1.000.000,00 のフォーマットで金額を入力できます。

real

整数 (1 など)、浮動値 (12.123 など)、科学的記数法による浮動値 (e を 10 の累乗数としたときの 1.212e+12、1.221e-12 など) など、さまざまな種類の数字や科学的記数法を検査します。

ip

IPv4 と IPv6 のいずれかまたは両方を検査します。

url

http://xxx.xxx.xxx、https://xxx.xxx.xxx、または ftp://xxx.xxx.xxx のフォーマットで URL を入力できます。

custom

カスタム検証の種類とフォーマットを指定できます。

整数の検査

 テキストフィールドに整数値のみを入力できるように設定するには、次に示すように、"integer" をコンストラクタの 2 番目のパラメータの値として追加します。
<script type="text/javascript">
	var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1", "integer");
</script>

整数検査が設定されたテキストフィールドには、負の値と正の値の両方を入力できます。 正の値のみを入力できるようにするには、allowNegative オプションを 3 番目のパラメータに追加し、その値を false に設定します。

<script type="text/javascript">
	var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1", "integer", {allowNegative:false});
</script>

次の表は、3 番目のパラメータで指定できるその他の一般的なオプションと値を示しています。

オプション

format

該当なし

validateOn

["blur"]; ["change"]; またはその両方 (["blur", "change"])

isRequired

true (デフォルト); false

useCharacterMasking

false (デフォルト); true

minChars/maxChars

該当なし

minValue/maxValue

整数値

pattern

該当なし

電子メールの検査

 テキストフィールドに標準の電子メールフォーマットのみを入力できるように設定するには、次に示すように、"email" をコンストラクタの 2 番目のパラメータの値として追加します。
<script type="text/javascript">
	var sprytextfield1= new Spry.Widget.ValidationTextField("sprytextfield1", "email");
</script>

次の構文を使用して、3 番目のパラメータのオプションを設定することもできます。

<script type="text/javascript">
	var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1", "email", {option:value});
</script>

次の表は、3 番目のパラメータで指定できる一般的なオプションと値を示しています。

オプション

format

該当なし

validateOn

["blur"]; ["change"]; またはその両方 (["blur", "change"])

isRequired

true (デフォルト); false

useCharacterMasking

該当なし

minChars/maxChars

正の整数値

minValue/maxValue

該当なし

pattern

該当なし

日付の検査

 テキストフィールドに日付フォーマットを入力できるように設定するには、次に示すように、"date" をコンストラクタの 2 番目のパラメータの値として追加します。
<script type="text/javascript">
	var sprytextfield1= new Spry.Widget.ValidationTextField("sprytextfield1", "date");
</script>

デフォルトの日付フォーマットは "mm/dd/yy" (米国の日付フォーマット) です。 ただし、format オプションを使用すると、他の多数の日付フォーマットを 3 番目のパラメータで設定できます。以下に例を示します。

<script type="text/javascript">
	var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1", "date", {format:"yyyy-mm-dd"});
</script>

次の表は、3 番目のパラメータで指定できるフォーマットオプションの完全なリスト、およびその他の一般的なオプションと値を示しています。

オプション

format

"mm/dd/yy" (デフォルト); "mm/dd/yyyy"; "dd/mm/yyyy"; "dd/mm/yy"; "yy/mm/dd"; "yyyy/mm/dd"; "mm-dd-yy"; "dd-mm-yy"; "yyyy-mm-dd"; "mm.dd.yyyy"; "dd.mm.yyyy";

validateOn

["blur"]; ["change"]; またはその両方 (["blur", "change"])

isRequired

true (デフォルト); false

useCharacterMasking

false (デフォルト); true

minChars/maxChars

該当なし

minValue/maxValue

指定されたフォーマットの日付値

pattern

該当なし

時刻の検査

 テキストフィールドに時刻フォーマットを入力できるように設定するには、次に示すように、"time" をコンストラクタの 2 番目のパラメータの値として追加します。
<script type="text/javascript">
	var sprytextfield1= new Spry.Widget.ValidationTextField("sprytextfield1", "time");
</script>

デフォルトの時刻フォーマットは "HH:mm" (時間および分) です。 ただし、format オプションを使用すると、他の多数の時刻フォーマットを 3 番目のパラメータで設定できます。以下に例を示します。

<script type="text/javascript">
	var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1", "time", {format:"HH:mm:ss"});
</script>

次の表は、3 番目のパラメータで指定できるフォーマットオプションの完全なリスト、およびその他の一般的なオプションと値を示しています。

オプション

format

"HH:mm" (デフォルト); "HH:mm:ss"; "hh:mm tt"; "hh:mm:ss tt"; "hh:mm t"; "hh:mm;ss t"; ("tt" は am/pm フォーマットを表し、"t" は a/p フォーマットを表します。)

validateOn

["blur"]; ["change"]; またはその両方 (["blur", "change"])

isRequired

true (デフォルト); false

useCharacterMasking

false (デフォルト); true

minChars/maxChars

該当なし

minValue/maxValue

指定されたフォーマットの時刻値

pattern

該当なし

クレジットカードの検査

 テキストフィールドにクレジットカードフォーマットを入力できるように設定するには、次に示すように、"credit_card" をコンストラクタの 2 番目のパラメータの値として追加します。
<script type="text/javascript">
	var sprytextfield1= new Spry.Widget.ValidationTextField("sprytextfield1", "credit_card");
</script>

デフォルトでは、すべての種類のクレジットカードが検査されます。ただし、format オプションを使用すると、特定のクレジットカードフォーマットを 3 番目のパラメータで指定できます。以下に例を示します。

<script type="text/javascript">
	var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1", "credit_card", {format:"visa"});
</script>

次の表は、3 番目のパラメータで指定できるフォーマットオプションの完全なリスト、およびその他の一般的なオプションと値を示しています。

オプション

format

フォーマットなし (デフォルト); "visa"; "mastercard"; "amex"; "discover"; "dinersclub"

validateOn

["blur"]; ["change"]; またはその両方 (["blur", "change"])

isRequired

true (デフォルト); false

useCharacterMasking

false (デフォルト); true

minChars/maxChars

該当なし

minValue/maxValue

該当なし

pattern

該当なし

郵便番号の検査

 テキストフィールドに郵便番号フォーマットを入力できるように設定するには、次に示すように、"zip_code" をコンストラクタの 2 番目のパラメータの値として追加します。
<script type="text/javascript">
	var sprytextfield1= new Spry.Widget.ValidationTextField("sprytextfield1", "zip_code");
</script>

デフォルトのフォーマットは、米国の 5 桁の郵便番号フォーマットです。ただし、format オプションを使用すると、他の多数のフォーマットを 3 番目のパラメータで指定できます。以下に例を示します。

<script type="text/javascript">
	var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1", "zip_code", {format:"zip_uk"});
</script>

次の表は、3 番目のパラメータで指定できるフォーマットオプションの完全なリスト、およびその他の一般的なオプションと値を示しています。

オプション

format

"zip_us5" (デフォルト); "zip_us9"; "zip_uk"; "zip_canada"; "zip_custom"

validateOn

["blur"]; ["change"]; またはその両方 (["blur", "change"])

isRequired

true (デフォルト); false

useCharacterMasking

false (デフォルト); true

minChars/maxChars

該当なし

minValue/maxValue

該当なし

pattern

カスタム郵便番号のパターンです。 format に "zip_custom" を指定する場合に使用します。

"zip_custom" フォーマットを使用すると、カスタマイズした独自のパターンを郵便番号フォーマットとして指定できます。 "zip_custom" をフォーマットとして指定した後、パターンオプションを 3 番目のパラメータに追加してフォーマットを定義します。 たとえば、3 桁の数字の後に他の数字や大文字と小文字が区別されるアルファベット文字が続く郵便番号の検査が必要になる場合があります。 カスタムパターンを指定するには、コンストラクタの 3 番目のパラメータで、format オプションの後に pattern オプションを追加します。以下に例を示します。

<script type="text/javascript">
	var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1", "zip_code", {format:"zip_custom", pattern:"000 00AA"});
</script>

次の表は、カスタムパターンに使用する値の完全なリストです。

説明

"0"

0 ~ 9 の整数です。

"A"

大文字のアルファベットです。

"a"

小文字のアルファベットです。

"B"; "b"

大文字と小文字を区別しないアルファベットです。

"X"

大文字の英数字です。

"x"

小文字の英数字です。

"Y"; "y"

大文字と小文字を区別しない英数字です。

"?"

任意の文字です。

"A"、"a"、"X"、および "x" のカスタムパターン文字では、大文字と小文字が区別されます。 これらの文字を使用する場合、ユーザーが大文字と小文字を誤って入力しても、正しい文字に自動的に変換されます。

電話番号の検査

 テキストフィールドに電話番号フォーマットを入力できるように設定するには、次に示すように、"phone_number" をコンストラクタの 2 番目のパラメータの値として追加します。
<script type="text/javascript">
	var sprytextfield1= new Spry.Widget.ValidationTextField("sprytextfield1", "phone_number");
</script>

デフォルトのフォーマットは、米国の地域コードと電話番号のフォーマットである (000) 000-0000 です。ただし、"phone_custom" オプションと "pattern" オプションを使用すると、カスタムフォーマットを 3 番目のパラメータで指定できます。以下に例を示します。

<script type="text/javascript">
	var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1", "zip_code", {format:"phone_custom" , pattern:"00 0000 A"});
</script>

次の表は、カスタムパターンに使用する値の完全なリストです。

説明

"0"

0 ~ 9 の整数です。

"A"

大文字のアルファベットです。

"a"

小文字のアルファベットです。

"B"; "b"

大文字と小文字を区別しないアルファベットです。

"X"

大文字の英数字です。

"x"

小文字の英数字です。

"Y"; "y"

大文字と小文字を区別しない英数字です。

"?"

任意の文字です。

"A"、"a"、"X"、および "x" のカスタムパターン文字では、大文字と小文字が区別されます。 これらの文字を使用する場合、ユーザーが大文字と小文字を誤って入力しても、正しい文字に自動的に変換されます。

次の表は、3 番目のパラメータで指定できるその他の一般的なオプションと値を示しています。

オプション

format

"phone_number" (デフォルト); "phone_custom"

validateOn

["blur"]; ["change"]; またはその両方 (["blur", "change"])

isRequired

true (デフォルト); false

useCharacterMasking

false (デフォルト); true

minChars/maxChars

該当なし

minValue/maxValue

該当なし

pattern

カスタム電話番号のパターンです。 format に "phone_custom" を指定する場合に使用します。

社会保障番号の検査

 テキストフィールドに社会保障番号フォーマットを入力できるように設定するには、次に示すように、"social_security_number" をコンストラクタの 2 番目のパラメータの値として追加します。
<script type="text/javascript">
	var sprytextfield1= new Spry.Widget.ValidationTextField("sprytextfield1", "social_security number");
</script>

デフォルトのフォーマットは、米国のダッシュ付き社会保障番号である 000-00-0000 です。ただし、pattern オプションを使用すると、カスタムフォーマットを 3 番目のパラメータで指定できます。以下に例を示します。

<script type="text/javascript">
	var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1", "social_security_number", {format:"custom" pattern:"00 0000 A"});
</script>

次の表は、カスタムパターンに使用する値の完全なリストです。

説明

"0"

0 ~ 9 の整数です。

"A"

大文字のアルファベットです。

"a"

小文字のアルファベットです。

"B"; "b"

大文字と小文字を区別しないアルファベットです。

"X"

大文字の英数字です。

"x"

小文字の英数字です。

"Y"; "y"

大文字と小文字を区別しない英数字です。

"?"

任意の文字です。

"A"、"a"、"X"、および "x" のカスタムパターン文字では、大文字と小文字が区別されます。 これらの文字を使用する場合、ユーザーが大文字と小文字を誤って入力しても、正しい文字に自動的に変換されます。

次の表は、3 番目のパラメータで指定できるその他の一般的なオプションを示しています。

オプション

format

該当なし

validateOn

["blur"]; ["change"]; またはその両方 (["blur", "change"])

isRequired

true (デフォルト); false

useCharacterMasking

false (デフォルト); true

minChars/maxChars

該当なし

minValue/maxValue

該当なし

pattern

カスタム社会保障番号のパターンです。

通貨の検査

 テキストフィールドに通貨フォーマットを入力できるように設定するには、次に示すように、"currency" をコンストラクタの 2 番目のパラメータの値として追加します。
<script type="text/javascript">
	var sprytextfield1= new Spry.Widget.ValidationTextField("sprytextfield1", "currency");
</script>

デフォルトのフォーマットは、米国の通貨フォーマットである 1,000.00 です。ただし、次に示すように、"dot_comma" フォーマット (1.000,00) を 3 番目のパラメータで指定できます。

<script type="text/javascript">
	var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1", "currency", {format:"dot_comma"});
</script>

いずれの場合も、3 桁ごとの区切り文字と小数部 (1,000.00 の「.00」) は必須ではありません。

次の表は、3 番目のパラメータで指定できるその他の一般的なオプションを示しています。

オプション

format

"comma_dot" (デフォルト); "dot_comma"

validateOn

["blur"]; ["change"]; またはその両方 (["blur", "change"])

isRequired

true (デフォルト); false

useCharacterMasking

false (デフォルト); true

minChars/maxChars

該当なし

minValue/maxValue

小数点以下 2 桁の数値

pattern

該当なし

実数および科学的記数法の検査

 テキストフィールドに実数および科学的記数法を入力できるように設定するには、次に示すように、"real" をコンストラクタの 2 番目のパラメータの値として追加します。
<script type="text/javascript">
	var sprytextfield1= new Spry.Widget.ValidationTextField("sprytextfield1", "real");
</script>

テキストフィールドでは、1.231e10 などの科学的記数法の実数が検査されます。

次の表は、3 番目のパラメータで指定できるその他の一般的なオプションを示しています。

オプション

format

該当なし

validateOn

["blur"]; ["change"]; またはその両方 (["blur", "change"])

isRequired

true (デフォルト); false

useCharacterMasking

false (デフォルト); true

minChars/maxChars

該当なし

minValue/maxValue

小数を含む数値

pattern

該当なし

IP アドレスの検査

 テキストフィールドで IP アドレスを検査するように設定するには、次に示すように、"ip" をコンストラクタの 2 番目のパラメータとして追加します。
<script type="text/javascript">
	var sprytextfield1= new Spry.Widget.ValidationTextField("sprytextfield1", "ip");
</script>

デフォルトで入力できる IP アドレスフォーマットは IPv4 です。ただし、format オプションを使用すると、その他の IP アドレスフォーマットを 3 番目のパラメータで設定できます。以下に例を示します。

<script type="text/javascript">
	var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1", "ip", {format:"ipv6"});
</script>

次の表は、3 番目のパラメータで指定できるフォーマットオプションとその他の一般的なオプションを示しています。

オプション

format

"ipv4" (デフォルト); "ipv6"; "ipv4_ipv6"

validateOn

["blur"]; ["change"]; またはその両方 (["blur", "change"])

isRequired

true (デフォルト); false

useCharacterMasking

false (デフォルト); true

minChars/maxChars

該当なし

minValue/maxValue

該当なし

pattern

該当なし

URL の検査

 テキストフィールドに URL 値のみを入力できるように設定するには、次に示すように、"url" をコンストラクタの 2 番目のパラメータの値として追加します。
<script type="text/javascript">
	var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1", "url");
</script>

URL 検査が設定されたテキストフィールドには、HTTP、HTTPS、および FTP の URL 値を入力できます。

次の表は、3 番目のパラメータで指定できるその他の一般的なオプションを示しています。

オプション

format

該当なし

validateOn

["blur"]; ["change"]; またはその両方 (["blur", "change"])

isRequired

true (デフォルト); false

useCharacterMasking

該当なし

minChars/maxChars

正の整数値

minValue/maxValue

該当なし

pattern

該当なし

カスタムフォーマットの検査

 テキストフィールドに任意の種類のカスタムフォーマットを入力できるように設定するには、次に示すように、"custom" を 2 番目のパラメータの値として指定し、pattern オプションを 3 番目のパラメータに追加します。
<script type="text/javascript">
	var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1", "custom", {pattern:"00 0000 AX"});
</script>

次の表は、カスタムパターンに使用する値の完全なリストです。

説明

"0"

0 ~ 9 の整数です。

"A"

大文字のアルファベットです。

"a"

小文字のアルファベットです。

"B"; "b"

大文字と小文字を区別しないアルファベットです。

"X"

大文字の英数字です。

"x"

小文字の英数字です。

"Y"; "y"

大文字と小文字を区別しない英数字です。

"?"

任意の文字です。

"A"、"a"、"X"、および "x" のカスタムパターン文字では、大文字と小文字が区別されます。 これらの文字を使用する場合、ユーザーが大文字と小文字を誤って入力しても、正しい文字に自動的に変換されます。

 

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/ja_JP/Spry/1.4/WS1E0F313C-63AB-4cf4-A339-420E95F9C1B4.html