テキストフィールド検査 Widget では、さまざまな検査の種類、フォーマット、およびその他のオプションを指定できます。 たとえば、クレジットカード番号を入力するテキストフィールドにはクレジットカード検査を指定できます。
検査の種類、フォーマット、およびその他のオプションは、Widget コンストラクタのパラメータとして指定します。 コンストラクタの最初のパラメータは Widget コンテナ ID です。その後に検査の種類を 2 番目のパラメータとして指定し、さらにオプションで 3 番目のパラメータを指定します。 3 番目のパラメータは、2 番目のパラメータで設定した検査の種類に依存するオプションの JavaScript 配列です。 したがって、2 番目のパラメータを設定しない場合、3 番目のパラメータは設定できません。
次のコードは、テキストフィールド Widget コンストラクタにさまざまなパラメータを指定するための一般的な構文を示しています。
<script type="text/javascript">
var sprytextfield1= new Spry.Widget.ValidationTextField("WidgetContainerID", "ValidationType", {option1:"value1", option2:"value2", ..});
</script>
検査の種類のオプションほとんどの検査では、検査が行われるために標準のフォーマットが必要になります。 たとえばテキストフィールドに整数検査を適用した場合は、テキストフィールドに数字が入力されない限り検査は行われません。 ただし検査の種類によっては、テキストフィールドに入力できるフォーマットの種類を選択できます。
|
検査の種類 |
フォーマット |
|---|---|
|
none |
特別なフォーマットは不要です。 |
|
integer |
数字のみを入力できます。 |
|
|
@ 記号およびピリオド (.) を含み、ピリオドの前後に 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