5.8 uji:fieldTextArea

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

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

ブラウザ対応状況

基本機能

uji:fieldTextAreaタグは、複数行テキストフィールドを作成します。

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

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

アトリビュート

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

アトリビュート名	省略	意味	省略時の動作
bean	可	データBeanのJSP変数名を指定します。	画面部品タグのカレントオブジェクトを使用します。
property	可	データBeanのプロパティ名を指定します。	データBean自体がFieldTextAreaModelインタフェースを持つオブジェクトとして使用されます。
width	可	フィールドの幅を指定します。(*)	標準の幅となります。
height	可	フィールドの高さを指定します。(*)	標準の高さとなります。
borderColor	可	フィールド枠の色を指定します。(*)	標準の色となります。
borderType	可	フィールド枠の形式を指定します。(*)	標準の形式となります。
borderWidth	可	フィールド枠の線幅を指定します。(*)	標準の線幅となります。
insets	可	フィールド内側の余白の幅を指定します。(*)	標準の余白となります。
background	可	フィールドの背景色を指定します。(*)	標準の背景色となります。
foreground	可	文字色を指定します。(*)	標準の文字色となります。
fontStyle	可	文字スタイルを指定します。(*)	標準の文字スタイルとなります。
fontWeight	可	文字の太さを指定します。(*)	標準の太さとなります。
fontSize	可	文字の大きさを指定します。(*)	標準の大きさとなります。
textDecoration	可	文字の装飾形式を指定します。(*)	標準の装飾形式となります。
enabled	可	項目の操作の可否をtrue/falseで指定します。	true
editable	可	項目の編集の可否をtrue/falseで指定します。	true
alignmentHorizontal	可	フィールド内の文字列の横位置を指定します。left、center、rightのいずれかを指定します。	left
verticalAlignment	可	フィールドの縦位置合わせ方法を指定します。(*)	標準値となります。
tabIndex	可	タブ順を数値で指定します。	配置順となります。
tipText	可	マウスポイント時に表示するティップの文字列を指定します。	表示しません。
maxLength	可	最大入力文字数を指定します。()(*)	チェックしません。
maxByteLength	可	最大入力バイト数（日本語2バイト換算）を指定します。UTF-16で0100-FF5Fの範囲の文字を日本語として扱います。(**)	チェックしません。
indispensableField	可	必須入力をtrue/falseで指定します。(**)	チェックしません。
infoText	可	エラー表示時に、メッセージに付加する文字列を指定します。(**)	表示しません。
columns	不可	桁数を数値で指定します。	省略できません。
rows	不可	行数を数値で指定します。	省略できません。
wrap	可	自動改行の方法を指定します。(*)	標準値となります。
enableChars	可	有効文字を[A-Z]のような正規表現形式で指定します。()(**)	チェックしません。
css	可	class属性の属性値を指定します。以下のタグにclass属性を設定します。 TEXTAREA	class属性を出力しません。
visible	可	項目の表示の有無をtrue/falseで指定します。	true
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:fieldTextAreaタグのコンテントは記述できません。

使用例

JSP

<uji:fieldTextArea bean="body" property="textData"
         columns="40" rows="5" foreground="green" wrap="soft" />

注意事項

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

XML連携機能

uji:fieldTextAreaタグは、複数行テキストフィールドを作成します。

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

アトリビュート

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

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

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

XMLデータの構造

propertyまたはxpathには単純要素を指定します。
propertyまたはxpathで指定した要素の内容には1行分のデータを記述します。要素の内容に改行が含まれる場合、改行の直前までが使用されます。
複数行のデータを設定する場合は、行数分の要素を記述します。

使用例

XML

<root>
  <textAreaData>文字列データ1</textAreaData>
  <textAreaData>文字列データ2</textAreaData>
  <textAreaData>文字列データ3</textAreaData>
</root>

JSP

<uji:fieldTextArea bean="body" xpath="textAreaData"
                     columns="40" rows="5" wrap="hard" />

表示画面

イベントモデル

uji:fieldTextAreaタグは、複数行テキストフィールドを作成します。

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

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

アトリビュート

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

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

コンテント

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

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

使用例

JSP

<f:view>
  <uji:form name="myform">
    <uji:fieldTextArea bean="myBean" property="textData"
             columns="40" rows="5" foreground="green" wrap="soft" />
  </uji:form>
</f:view>

注意事項

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

ブラウザ対応状況

アトリビュート	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	○	○	×
enabled	○	○	○	○	○	○	※3
editable	○	○	○	○	○	○	○
alignmentHorizontal	○	○	○	○	○	○	○
verticalAlignment	※4	※4	※4	※4	○	○	○
tabIndex	○	○	○	○	○	○	○
tipText	○	○	○	○	○	○	○
maxLength	○	○	○	○	○	○	○
maxByteLength	○	○	○	○	○	○	○
indispensableField	○	○	○	○	○	○	○
infoText	○	○	○	○	○	○	○
columns	○	○	○	○	※5	※5	○
rows	○	○	○	○	※5	※5	○
wrap	○	○	○	○	※6	※6	○
css	※7	※7	※7	※7	※7	※7	※7
grayed	○	○	○	○	○	○	○

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

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

※3: false指定時に文字がグレーになりません。

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

※5: 指定した行数または列数を超える入力でスクロールバーが表示されます。またwrapの指定にかかわらず、横スクロールバーが表示されます。

※6: 単語の途中では折り返されません。

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