ストリングでない場合のデータ形式を定義します。
カテゴリ
data
構文
<xp:this.converter>converter</xp:this.converter>
ここで、
converter は以下のいずれかです。
<xp:convertBoolean attributes>content</xp:convertBoolean>
<xp:convertNumber attributes>content</xp:convertNumber>
<xp:convertDateTime attributes>content</xp:convertDateTime>
<xp:convertMask attributes>content</xp:convertMask>
<xp:customConverter></xp:customConverter>
使用法
設計モードで、[プロパティ] の下の [データ] タブをクリックし、[表示タイプ] を探すか、[すべてのプロパティ] をクリックし、[data] の下の [converter] を探します。
含まれるプロパティ
コンバータには以下のプロパティがあります。
表 1. ブール変換に含まれるプロパティ| プロパティ |
説明 |
|---|
loaded="true|false"
|
ページのロード時にタグインスタンスを作成するかどうか。 デフォルトは true です。 |
message="message text"
|
strict="true" で、ユーザーが true でも false でもない値を入力した場合の、ユーザーに対するメッセージ。
このメッセージは、データの送信時に表示されます。 |
strict="true|false"
|
true の場合は、true と false のみを入力値として受け入れます。
デフォルトでは、true 以外の入力値はすべて false と見なされます。 |
表 2. 数値変換に含まれるプロパティ| プロパティ |
説明 |
|---|
currencyCode="option"
|
ISO 4712 通貨コード (USD など)。 |
currencySymbol="symbol"
|
通貨記号。 |
groupingUsed="true|false"
|
「グループ化の分離記号」を使用するかどうか。
デフォルトは true です。 |
integerOnly="true|false"
|
値の小数部を切り捨てて整数にするかどうか。 デフォルトは false。 |
loaded="true|false"
|
ページのロード時にタグインスタンスを作成するかどうか。 デフォルトは true です。 |
locale="option"
|
言語と国コード (en_US など)。 |
maxFractionDigits="n"
|
数字の小数部の最大桁数。 |
maxIntegerDigits="n"
|
数字の整数部の最大桁数。 |
minFractionDigits="n"
|
数字の小数部の最小桁数。 |
minIntegerDigits="n"
|
数字の整数部の最小桁数。 |
pattern="pattern"
|
変換された数値をフォーマットするためのユーザー定義パターン。 |
type="number|currency|percent"
|
変換用のフォーマット設定。 デフォルトは number です。 |
表 3. 日付/時刻変換に含まれるプロパティ| プロパティ |
説明 |
|---|
dateStyle="default|short|medium|long|full"
|
データ値の定義済みフォーマット設定。 |
ignoreUserTimeZone="true|false"
|
プラットフォームのタイムゾーンを適用してユーザーのタイムゾーンを無視するかどうか。 |
loaded="true|false"
|
ページのロード時にタグインスタンスを作成するかどうか。 デフォルトは true です。 |
locale="option"
|
言語と国コード (en_US など)。 |
pattern="pattern"
|
変換された日付/時刻値をフォーマットするためのユーザー定義パターン。 |
timeStyle="default|short|medium|long|full"
|
時刻値の定義済みフォーマット設定。 |
timeZone="option"
|
フォーマット設定された値のタイムゾーン (US/Eastern など)。 |
type="date|time|both"
|
フォーマット設定の対象部分。 デフォルトは date です。 |
表 4. マスク変換に含まれるプロパティ| プロパティ |
説明 |
|---|
asis="true|false"
|
マスクされた入力以外のデータを削除するかどうか。 デフォルトは false。 |
loaded="true|false"
|
ページのロード時にタグインスタンスを作成するかどうか。 デフォルトは true です。 |
mask="mask"
|
マスク文字 (数字のプレースホルダーとして #、文字のプレースホルダーとして ? を使用)。 |
例
この編集ボックスは、関連するデータを数値に変換します。
<xp:inputText id="inputText1" value="#{document1.quantity}">
<xp:this.converter>
<xp:convertNumber type="number"></xp:convertNumber>
</xp:this.converter>
</xp:inputText>
この編集ボックスは、関連するデータをブール値に変換します。
<xp:inputText id="inputText1" value="#{document1.ispublic}">
<xp:this.converter>
<xp:convertBoolean" strict="true" message="Enter true or false for ispublic"></xp:convertBoolean>
</xp:this.converter>
</xp:inputText>
