NumeralOnlyLimiterはLimiterのひとつであり、入力文字を数値に関する文字だけに制限する機能付加部品です。
NumeralOnlyLimiterを使用すると、デフォルトでは数字だけが入力できます。
プロパティの設定により、小数点、3桁区切り文字、負号を入力可能とすることができます。小数点と負号は、入力位置および個数が制約されます。
小数点や負号が入力可能な場合、文字列のペーストでは、入力位置および個数に制約があります。ペーストした結果は、ペースト文字列の先頭から1文字ずつ入力した場合と同じ結果となります。
例1: 入力フィールドが「-123」(負号入力可能)で、先頭に「999」をペーストしようとした場合、負号の前には文字は入力不可なので、何もペーストされません。
例2: 入力フィールドが空で、ペースト文字列が「12.34.56」の場合、「12.3456」がペーストされます。(12のうしろの小数点は有効、34のうしろの小数点は2個目となるため無効)
機能付加対象は以下のとおりです。
注意
NumeralOnlyLimiterを利用できるブラウザ
NumeralOnlyLimiterは、Internet Explorerでだけ利用可能な部品です。ほかのブラウザでは動作しません。また、Limiterは、1つの部品につき1つだけ設定できます。
NumeralOnlyLimiterを追加すると、入力フィールドに以下の制約が追加されます。
IMEを使った入力はできません。(IMEは常に無効です。)
上書き入力はできません。常に挿入による入力になります。
記述形式
<div rcf:type="NumeralOnlyLimiter" rcf:target="xxx"></div>
または
<span rcf:type="NumeralOnlyLimiter" rcf:target="xxx"></span>
注意
子要素は記述できません。詳細は、「5.1.4 子要素を持たない部品に子要素を記述した場合の動作」を参照してください。
本部品は画面に表示されないため、<div>タグおよび<span>タグのどちらで記述しても違いはありません。
プロパティ
表の項目の意味は、「Text」の「プロパティ」を参照してください。
名前 | データ型 | 説明 | 省略 | 省略値 | 属性指定 | 更新 | 部分更新 |
|---|---|---|---|---|---|---|---|
target | String | 機能付加対象のrcf:idを指定します。 | 不可 | － | 値 | 不可 | 不可 |
decimalSeparator | String | 小数点記号を指定します。(1文字の半角特殊文字または英字) | 可 | "" | 値 | 不可 | 不可 |
groupSeparator | String | 1000の区切り文字を指定します。(1文字の半角特殊文字または英字) | 可 | "" | 値 | 不可 | 不可 |
minusSign | String | マイナス記号を指定します。(1文字の半角特殊文字または英字) | 可 | "" | 値 | 不可 | 不可 |
allowPaste | Boolean | ペーストの有効/無効を指定します。
| 可 | false | 値 | 不可 | 不可 |
そのほかにも、画面部品および機能付加部品で共通のプロパティを指定することができます。詳細は、「2.8.1 画面部品共通プロパティ」、および「4.4.1 機能付加部品共通プロパティ」を参照してください。
イベントリスナ
固有のイベントリスナはありません。
JavaScript API
固有のJavaScript APIはありません。
