5.1 uji:fieldString

uji:fieldStringについて説明します。uji:fieldStringには、以下の機能があります。

また、ブラウザによる対応状況についても説明します。

ブラウザ対応状況

基本機能

uji:fieldStringタグは、文字列入力フィールドを作成します。

beanとpropertyで指定されたデータBeanのプロパティに対応して、データを表示・入力します。指定されたデータがFieldStringModelインタフェースを持つ場合は、データBean側で文字色などのいくつかの書式を指定することができます。データBean側とアトリビュートと双方で書式を設定した場合は、データBeanの指定が優先されます。FieldStringModelインタフェースの代わりに外付け属性を利用する方法については、“Apcoordinatorユーザーズガイド”を参照してください。

uji:fieldStringタグは、HTMLのFORMタグか、uji:formタグまたはuji:mcFormタグの中に記述します。

アトリビュート

uji:fieldStringタグのアトリビュートは以下を指定します。

アトリビュート名	省略	意味	省略時の動作
bean	可	データBeanのJSP変数名を指定します。	画面部品タグのカレントオブジェクトを使用します。
property	可	データBeanのプロパティ名を指定します。	データBean自体がFieldStringModelインタフェースを持つオブジェクトとして使用されます。
width	可	フィールドの幅を指定します。(*)	標準の幅となります。
height	可	フィールドの高さを指定します。(*)	標準の高さとなります。
borderColor	可	フィールド枠の色を指定します。(*)	標準の色となります。
borderType	可	フィールド枠の形式を指定します。(*)	標準の形式となります。
borderWidth	可	フィールド枠の線幅を指定します。(*)	標準の線幅となります。
insets	可	フィールド内側の余白の幅を指定します。(*)	標準の余白となります。
background	可	フィールドの背景色を指定します。(*)	標準の背景色となります。
foreground	可	文字色を指定します。(*)	標準の文字色となります。
fontStyle	可	文字スタイルを指定します。(*)	標準の文字スタイルとなります。
fontWeight	可	文字の太さを指定します。(*)	標準の太さとなります。
fontSize	可	文字の大きさを指定します。(*)	標準の大きさとなります。
textDecoration	可	文字の装飾形式を指定します。(*)	標準の装飾形式となります。
visible	可	項目の表示の有無をtrue/falseで指定します。	true
enabled	可	項目の操作の可否をtrue/falseで指定します。	true
editable	可	項目の編集の可否をtrue/falseで指定します。	true
plain	可	trueの場合、項目を入力フィールドではなく通常文字で表示します。	false
alignmentHorizontal	可	フィールド内の文字列の横位置を指定します。left、center、rightのいずれかを指定します。	left
verticalAlignment	可	フィールドの縦位置合わせ方法を指定します。(*)	標準値となります。
tabIndex	可	タブ順を数値で指定します。	配置順となります。
tipText	可	マウスポイント時に表示するティップの文字列を指定します。	表示しません。
maxLength	可	最大入力文字数を指定します。()(*)	チェックしません。
maxByteLength	可	最大入力バイト数（日本語2バイト換算）を指定します。UTF-16で0100-FF5Fの範囲の文字を日本語として扱います。(**)	チェックしません。
indispensableField	可	必須入力をtrue/falseで指定します。(**)	チェックしません。
fullField	可	全桁入力をtrue/falseで指定します。maxLengthまたはmaxByteLengthの指定が必要です。(**)	チェックしません。
autoEscape	可	自動脱出をtrue/falseで指定します。maxLengthの指定が必要です。また、IMEを使用しない直接入力の場合にのみ有効です。(**)	自動脱出しません。
infoText	可	エラー表示時に、メッセージに付加する文字列を指定します。(**)	表示しません。
password	可	パスワード入力をtrue/falseで指定します。	チェックしません。
uppercase	可	入力内容を大文字化する場合trueを指定します。データBeanに格納されているデータの大文字化は行われません。	大文字化しません。
enableChars	可	有効文字を[A-Z]のような正規表現形式で指定します。()(**)	チェックしません。
enableCharType	可	有効文字種を指定します。()(*)	チェックしません
css	可	class属性の属性値を指定します。以下のタグにclass属性を設定します。 INPUTまたはSPAN	class属性を出力しません。
grayed	可	操作無効、グレー表示の可否をtrue/falseで指定します。trueを指定した場合は、enabled=false background=silverとなります。	enabledアトリビュートおよびbackgroundアトリビュートの指定となります。
event	可	イベント発生時に実行するJavaScriptを記述します。	イベント発生時にJavaScriptを実行しません。

(*)“7.7.1 項目の指定方法”を参照してください。

(**)uji:formタグまたはuji:mcFormタグを使用し、かつ、plainがfalseの場合のみ有効になります。

(***)補助文字の扱いについては“7.3 補助文字の文字数の数え方”を参照してください。

コンテント: uji:fieldStringタグのコンテントは記述できません。

使用例

JSP

<uji:fieldString bean="body" property="stringData"
        width="120" height="40" background="yellow" foreground="blue" />

注意事項

beanアトリビュートは画面部品タグのレンダラの中で、カレントオブジェクトが利用できる場合にのみ省略できます。
HTMLに展開されるときに改行コードが挿入されます。改行コードが不要な場合は本タグは使用しないでください。
各ブラウザでそれぞれのアトリビュートが有効かどうかは“ブラウザ対応状況”を参照してください。

XML連携機能

uji:fieldStringタグは、文字列入力フィールドを作成します。

イベントモデルではXML連携機能は利用できません。

アトリビュート

uji:fieldStringタグでは、XML連携機能を使用する際に以下のアトリビュートを指定します。これ以外のアトリビュートについては、“基本機能”を参照してください。

アトリビュート名	省略	意味	省略時の動作
bean	可	データBeanまたはXMLデータBeanのJSP変数を指定します。(*)	カレントオブジェクトを使用します。
property	可	表示と入力の対象となる要素をルート要素の子要素名で指定します。(*)	propertyまたはxpathいずれかの指定が必要です。
xpath	可	表示と入力の対象となる要素をルート要素からの相対パスで指定します。(*)	propertyまたはxpathいずれかの指定が必要です。

(*)“7.6.1 使用するXML要素の指定方法”を参照してください。

XMLデータの構造: propertyまたはxpathには単純要素を指定します。要素の内容に改行が含まれる場合、改行の直前までが使用されます。要素の集合を指定した場合の動作は“7.6.3 要素や属性の集合を指定した場合の動作”を参照してください。

使用例

XML

<root>
  <stringData>文字列データ</stringData>
</root>

JSP

文字列:<uji:fieldString bean="body" xpath="stringData"/>

表示画面

イベントモデル

uji:fieldStringタグは、文字列入力フィールドを作成します。

uji:fieldStringタグは、uji:formタグの中に記述します。

uji:fieldStringタグの動作については、“基本機能”を参照してください。

アトリビュート

uji:fieldStringタグは、イベントモデルで使用する際に以下のアトリビュートを指定します。これ以外のアトリビュートについては、“基本機能”を参照してください。

アトリビュート名	省略	意味	省略時の動作
bean	可	managed beanの名前を指定します。	画面部品タグのカレントオブジェクトを使用します。
property	可	managed beanのプロパティ名を指定します。	managed bean自体がFieldStringModelインタフェースを持つオブジェクトとして使用されます。
validator	可	バリデータメソッドをメソッドバインディング式で指定します。	バリデータを使用しません。
converter	可	コンバータをコンバータIDもしくはバリューバインディング式で指定します。	コンバータを使用しません。
valueChangeListener	可	バリューチェンジリスナメソッドをメソッドバインディング式で指定します。	バリューチェンジリスナメソッドを使用しません。
immediate	可	値の変換と検証を処理するフェーズを指定します。 trueの場合、Apply Request Valuesで処理されます。 falseの場合、Process Validatorsで処理されます。	false
id	可	コンポーネントのIDを指定します。	自動的に付与されます。

コンテント

uji:fieldStringタグのコンテントには以下のタグが記述できます。

f:validator(0個以上)
f:converter(最大1個)
f:valueChangeListener(0個以上)

使用例

JSP

 <f:view>
  <uji:form name="myform">
    <uji:fieldString bean="myBean" property="stringData"
                    width="120" height="40" background="yellow" foreground="blue" />
  </uji:form>
</f:view>

注意事項

uji:fieldStringタグでバリデータを利用する場合、バリデータに渡されるオブジェクトの型はjava.lang.Stringです。
uji:fieldStringタグでコンバータを利用する場合、getAsStringメソッドに渡される第3引数の型や、getAsObjectで返却するオブジェクトの型はjava.lang.Stringです。
標準コンバータを利用することはできません。
その他の注意事項については、“基本機能”を参照してください。

ブラウザ対応状況

各ブラウザにおけるアトリビュートの動作状況です。

以下の表で、「×」はアトリビュート設定値によらず省略時と同じ動作になることを示します。UJIタグで対応していないブラウザについては「－」で示しています。なお、製品名については次のように略して表記しています。

Windows版
- 「Microsoft Internet Explorer 5.5」→「IE5.5」
- 「Microsoft Internet Explorer 6」→「IE6」
- 「Internet Explorer 7」→「IE7」
- 「Internet Explorer 8」→「IE8」
- 「Mozilla Firefox 2.0」→「Firefox2.0」
- 「Mozilla Firefox 3.0」→「Firefox3.0」
Macintosh版
- 「Safari 2.0」→「Safari2.0」

アトリビュート	IE5.5	IE6	IE7	IE8	Firefox2.0	Firefox3.0	Safari2.0
width	○	○	○	○	○	○	○
height	○	○	○	○	○	○	×
borderColor	○	○	○	○	○	○	×
borderType	○	※1	※1	※1	○	○	×
borderWidth	○	○	○	○	○	○	×
insets	○	○	○	○	○	○	×
background	○	○	○	○	○	○	○
foreground	○	○	○	○	○	○	○
fontStyle	○	○	○	○	○	○	○
fontWeight	○	○	○	○	○	○	○
fontSize	○	○	○	○	○	○	○
textDecoration	※2	※2	※2	※2	○	○	×
visible	○	○	○	○	○	○	○
enabled	○	○	○	○	○	○	○
editable	○	○	○	○	○	○	○
plain	○	○	○	○	○	○	○
alignmentHorizontal	○	○	○	○	○	○	○
verticalAlignment	※3	○	○	○	○	○	×
tabIndex	○	○	○	○	○	○	○
tipText	○	○	○	○	○	○	○
maxLength	○	○	○	○	○	○	○
maxByteLength	○	○	○	○	○	○	○
indispensableField	○	○	○	○	○	○	○
fullField	○	○	○	○	○	○	○
autoEscape	○	○	○	○	○	○	○
infoText	○	○	○	○	○	○	○
password	○	○	○	○	○	○	○
uppercase	○	○	○	○	○	○	×
enableChars	○	○	○	○	○	○	○
enableCharType	○	○	○	○	○	○	○
css	※4	※4	※4	※4	※4	※4	※4
grayed	○	○	○	○	○	○	○

※1: Windows XPまたはWindows Vistaで、画面のテーマを[Windows XP]または[Windows Vista]に設定している場合は有効になりません。

※2: blinkは指定できません。

※3: 実数値＋単位は、指定不可です。

※4: CSSを使った設定が実際に表示に反映されるかどうかはブラウザの仕様に依存します。