Ajaxフレームワーク UI部品リファレンス
目次 索引 前ページ次ページ

第4章 機能付加部品> 4.1 入力支援機能

4.1.3 NumeralOnlyLimiter

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を追加すると、入力フィールドに以下の制約が追加されます。

述形式

<div rcf:type="NumeralOnlyLimiter" rcf:target="xxx"></div>

または

<span rcf:type="NumeralOnlyLimiter" rcf:target="xxx"></span>


子要素は記述できません。
本部品は画面に表示されないため、<div>タグおよび<span>タグのどちらで記述しても違いはありません。

ロパティ

表の項目の意味は、“表の項目の意味”を参照してください。

名前

データ型

説明

省略

省略値

属性指定

更新

部分更新

target

String

機能付加対象のrcf:idを指定します。

不可

不可

不可

decimalSeparator

String

小数点記号を指定します。(1文字の半角特殊文字または英字)
指定された場合、指定された値を小数点記号と解釈し、入力を許可します。
小数点記号は入力文字列内に1つしか入力できません。
2文字以上は指定できません。また、groupSeparatorおよびminusSignと同じ文字は指定できません。
デフォルトでは、何も入力を許可しません。

""

不可

不可

groupSeparator

String

1000の区切り文字を指定します。(1文字の半角特殊文字または英字)
指定した場合、指定された文字を1000の区切り文字と解釈し、入力を許可します。
区切り文字の入力はどこにでもでき、3桁ごとのチェックは行われません。
2文字以上は指定できません。また、decimalSeparatorおよびminusSignと同じ文字は指定できません。
デフォルトでは、何も入力を許可しません。

""

不可

不可

minusSign

String

マイナス記号を指定します。(1文字の半角特殊文字または英字)
指定した場合、指定された文字をマイナス記号と解釈し、入力を許可します。
マイナス記号は、入力文字列の先頭にだけ入力できます。
2文字以上は指定できません。また、decimalSeparatorおよびgroupSeparatorと同じ文字は指定できません。
デフォルトでは、何も入力を許可しません。

""

不可

不可

allowPaste

Boolean

ペーストの有効/無効を指定します。

  • true:数字だけがペーストされます。
    ただし、decimalSeparator、groupSeparator、minusSignを設定した場合は、設定したそれぞれの値もペーストされます。
  • false:ペーストされません。

false

不可

不可

そのほかにも、画面部品および機能付加部品で共通のプロパティを指定することができます。詳細は、“画面部品共通プロパティ”、および“機能付加部品共通プロパティ”を参照してください。

ベントリスナ

固有のイベントリスナはありません。部品共通のイベントリスナは、“画面部品共通イベントリスナ”を参照してください。

JavaScript API

固有のJavaScript APIはありません。部品共通のJavaScript APIは、“画面部品共通JavaScript API”を参照してください。


目次 索引 前ページ次ページ

Copyright 2008 FUJITSU LIMITED