フォームのプロパティ:形式
[形式] プロパティ は、テキストボックスとドロップダウンに使用できます。これにより、デフォルトおよびカスタム形式のレンダリングと検証が可能になります。数字、日付、時刻、およびその他のさまざまな形式が常に 100 % 正しく入力されていることを確認する場合に非常に便利です。以下に説明するように、さまざまな形式のカテゴリがあります。
これがデフォルト設定です。形式は指定されていません。
数値形式を使用すると、Revu は入力テキストをすばやく解析し、特定の方法で出力テキストをフォーマットできます。選択すると、次のオプションが使用可能になります。
- [小数点以下の桁数]: [小数点以下の桁数] プロパティは、数値で許容される小数点 (「.」) の後の数字の数を決定します。たとえば、小数点以下の桁数を「 0 」に設定し、入力値が「12.345678」の場合、フィールドに「12」が表示されます。小数点以下の桁数を 3 に設定すると、フィールドに「12.345」と表示されます。
- 桁区切りのスタイル:桁区切りのスタイルは、読みやすくするために番号をグループ化するために使用されます。以下に例を示します。
- 1,234.56:入力したテキスト「123456789.0123」は「123,456,789.0123」と表示されます。
- 1234.56:入力したテキスト「123456789.0123」は「123456789.0123」と表示されます。
- 1.234,56:入力したテキスト「123456789.0123」は「123.456.789,0123」と表示されます。
- 1234,56:入力したテキスト「123456789.0123」は「123456789,0123」と表示されます。
- 1'234.56:入力したテキスト「123456789.0123」は「123'456'789.0123」と表示されます。
- [通貨記号]:表示する通貨記号を選択し、数値が金額を表すことを示します。たとえば、米ドルの通貨記号を使用して値 123.45 を入力すると、テキストボックスには $123.45 と表示されます。
- [記号の位置]:このプロパティは、レンダリングされた入力値の前または後に表示される記号を指定します。1) スペースあり前、2) スペースなし前、3) スペースあり後、4) スペースなし後、の 4 つのオプションがあります。
- [負値のスタイル]:負の値を表示するには、1)括弧、または 2)赤字の 2 つの方法があります。多くの会計アプリケーションでは、括弧で正の数値を囲むことで負の値を表示し、他のアプリケーションでは負の値が赤字で表示されます。
パーセンテージ形式を使用すると、入力テキストの 0 〜 1 の数値をすばやく解析し、出力テキストをパーセンテージで表示できます。選択すると、次のオプションが使用可能になります。
- [小数の位]:このプロパティは、小数点以下の桁数プロパティと同じように動作します。
- [桁区切りのスタイル]:このプロパティは、数の桁区切りのスタイルプロパティと同じように動作します。
日付形式を使用して、日付を入力、解析、および検証します。選択すると、次のオプションが使用可能になります。
[組み込みの日付オプション]:25 の組み込みの日付オプションがあります。次の表に、日付のフォーマットオプションを示します。
フォーマットトークン |
意味 |
メートル |
1 ~ 9 の月数 |
mm |
01 ~ 12 の月数 |
mmm |
月名の省略形 (例: 「 Jan」 ) |
mmmm |
完全な月名 (例: 「January」) |
直径 |
1 ~ 9 の日数 |
dd |
1 ~ 31 の日番号 |
ddd |
曜日の省略形 (例: 「 Fri 」 ) |
dddd |
完全な曜日名 (例: 「Friday」 ) |
yy |
年 (00 は 2000 の略) |
yyyy |
完全な年番号 |
HH |
24 時間形式の時刻 |
hh |
12 時間形式の時刻 |
mm |
分 |
ss |
秒 |
tt |
AM または PM |
[カスタム日付オプション]:別の形式が必要な場合、カスタム日付オプションを定義できます。上記の表を使用して、日付の外観をフォーマットするカスタムフォーマット文字列を定義できます。たとえば、 ss:MM:HH:dd:mm:yyyy
では、エントリ 00:31:15:11:02:2011 が 2/11/2011 3:31 PM としてフォーマットされます。
[時刻] :日付形式に似ていますが、タイムスタンプ用に設計されています。
- [組み込みの時刻オプション]:4 つの一般的な時刻オプションが組み込まれています。
- [カスタム時間オプション]:カスタム時間オプションは、日付フィールドのフォーマットと同様にフォーマットできます。
いくつかの特別な形式タイプがあります。形式タイプについて詳しく説明します。
- [郵便番号]:最終的に、これは正規表現
\d{0,5}
と照合されます。91101 などの番号は、有効な郵便番号として識別されます。 - [郵便番号 + 4]:これは、正規表現
\d{0,5}(\.|[- ])?\d{0,4}
と照合されます。91101-0123 などの番号は、有効な郵便番号として識別されます。
- [電話番号]:これは、次の正規表現のいずれかと照合されます。
\d{0,3}(\.|[- ])?\d{0,3}(\.|[- ])?\d{0,4}
\(\d{0,3}
\(\d{0,3}\)(\.|[- ])?\d{0,3}(\.|[- ])?\d{0,4}
\(\d{0,3}(\.|[- ])?\d{0,3}(\.|[- ])?\d{0,4}
\d{0,3}\)(\.|[- ])?\d{0,3}(\.|[- ])?\d{0,4}
011(\.|[- \d])*
888-888-8888や (888)888-8888 などの電話番号は、有効な電話番号として識別されます。
- [社会保障番号]:これは次の正規表現
\d{0,3}(\.|[- ])?\d{0,2}(\.|[- ])?\d{0,4}
と照合されます。000-00-0000 などの社会保障番号は、有効な社会保障番号として識別されます。
カスタム形式カテゴリは、どの組み込み形式も要件を満たさない場合に使用されます。カスタムフィールドのアプリケーション例は、E メールアドレスまたはベイツ番号です。
- [カスタムフォーマットスクリプト]:カスタム JavaScript を実行して、このフィールドへのユーザー入力を検証できます。以下は、テキストボックスに数字のみが入力されることを検証する例です。
//これをグローバル JavaScript に追加します
String.prototype.isNumber = function() {
var data = this.valueOf();
if (data.match(/^[0-9]+$/)) {
returntrue;
}
returnfalse;
};
OnCustomFormatEvent = function(event) {
var field = this.getField("Text1");
var data = new String(field.value);
if (data.isNumber()) {
event.value = "識別される番号" ;
}
else {
event.value = "識別されない番号" ;
}
};
//これを Text1 という名前のテキストボックスのカスタムフォーマットスクリプトに追加します
OnCustomFormatEvent(event);
カスタムフォーマットスクリプトを呼び出すと、event.value がイベントオブジェクトから読み取られます。他のプロパティ (event.rc など ) は無視されます。
- [カスタムキーストロークスクリプト] :このフィールドを使用して、ユーザーが入力するキーストロークごとに、スクリプトを実行するカスタムキーストロークスクリプトを指定します。次の例では、入力された数値が 1 〜 100 であることを確認します。
var data = new Number(event.value);
if (1 <= data && data <= 100) {
event.rc = false;
}
else {
event.rc = true;
}