ページの先頭行へ戻る
 ApcoordinatorUJIタグリファレンス
第5章 コンポーネントタグ > 5.16 uji:buttonList
前次

5.16 uji:buttonList

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

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

基本機能

uji:buttonListタグは、ボタンリストを作成します。uji:buttonListタグは以下の動作をします。

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

uji:listタグやuji:tableタグと組み合わせてリストの要素やテーブルのセルを選択するラジオボタンを利用したい場合や、タブ順を指定したい場合はuji:radioButtonタグを使用してください。

アトリビュート

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

アトリビュート名

省略

意味

省略時の動作

bean

可

データBeanのJSP変数を指定します。

画面部品タグのカレントオブジェクトを使用します。

property

可

データBeanのプロパティ名を指定します。

データBean自体がButtonListModelインタフェースを持つオブジェクトとして使用されます。

width

可

全体の幅を指定します。(*)

標準の幅となります。

height

可

全体の高さを指定します。(*)

標準の高さとなります。

borderColor

可

枠の色を指定します。(*)

標準の色となります。

borderType

可

枠の形式を指定します。(*)

標準の形式となります。

borderWidth

可

枠の線幅を指定します。(*)

標準の線幅となります。

insets

可

枠の内側の余白の幅を指定します。

(*) 標準の余白となります。

background

可

背景色を指定します。(*)

標準の背景色となります。

foreground

可

文字色を指定します。(*)

標準の文字色となります。

fontStyle

可

文字スタイルを指定します。(*)

標準の文字スタイルとなります。

fontWeight

可

文字の太さを指定します。(*)

標準の太さとなります。

fontSize

可

文字の大きさを指定します。(*)

標準の大きさとなります。

textDecoration

可

文字の装飾形式を指定します。(*)

標準の装飾形式となります。

enabled

可

項目選択の可否をtrue/falseで指定します。

true

columns

可

折り返しのカラム数を数値で指定します。

折り返しを行ないません。

multipleMode

可

複数選択が可能かどうかをtrue/falseで指定します。

false

css

可

class属性の属性値を指定します。以下のタグにclass属性を設定します。
TABLE, TR, TD, INPUT

class属性を出力しません。

visible

可

項目の表示の有無をtrue/falseで指定します。

true

event

可

イベント発生時に実行するJavaScriptを記述します。

イベント発生時にJavaScriptを実行しません。

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

コンテント

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

使用例

JSP

<uji:buttonList bean="body" property="button"
        columns="4" width="120" />
注意事項

  • beanアトリビュートは画面部品タグのレンダラの中で、カレントオブジェクトが利用できる場合にのみ省略できます。

  • 各ブラウザでそれぞれのアトリビュートが有効かどうかは“ブラウザ対応状況”を参照してください。

XML連携機能

uji:buttonListタグはボタンリストを作成します。ボタンリストはチェックボックスまたはラジオボタンの集合です。uji:buttonListタグは以下の動作をします。

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

アトリビュート

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

アトリビュート名

省略

意味

省略時の動作

bean

可

データBeanまたはXMLデータBeanのJSP変数を指定します。(*)

カレントオブジェクトを使用します。

property

可

ボタンリスト情報として使用する要素をルート要素の子要素名で指定します。(*)

ルート要素を使用します。

xpath

可

ボタンリスト情報として使用する要素をルート要素からの相対パスで指定します。(*)

ルート要素を使用します。

selectedXPath

可

ボタンの選択状態を保持する要素または属性を指定します。要素を指定する場合はルート要素からの相対パスで、属性を指定する場合はボタンとなる要素からの相対パスで指定します。(**)

ボタンの選択状態は保持されません。

valueAttr

可

ボタンの識別値として使用する属性を指定します。ボタンとなる要素の属性名で指定します。

ボタンとなる要素の内容を使用します。

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

(**)“7.6.2 属性指定時の注意”を参照してください。

XMLデータの構造

  • propertyまたはxpathには複合要素を指定します(*1)。指定された要素がボタンリスト情報として使用されます。

  • ボタンリスト情報の子要素がボタンとなります。単純要素だけがボタンになります。ボタンとなる要素の内容がボタンの表示文字列として使用されます(*2)。

  • selectedXPathには単純要素または属性を指定します。このアトリビュートで選択状態の保持方法を指定します。

    • 単純要素を指定した場合、その要素の内容で選択状態を表します。その内容はボタンを識別する値です(*2)。ボタンとなる要素の属性のうち、valueAttrで指定された属性の値がボタンの識別値として使用されます。valueAttr省略時はボタンとなる要素の要素名が識別値となります。

    • 属性を指定した場合、ボタンとなる要素の属性で選択状態を表します。選択済みのボタンでは、selectedXPathで指定された属性の値は"true"です。選択されていないボタンでは"false"です。なお、"true"、"false"の大文字小文字は区別しません。

    データ入力時には、selectedXPathで指定したデータが更新されます。画面表示時は、selectedXPathで指定したデータに従って選択状態が決まります。

  • multipleModeアトリビュートで"true"を指定して複数選択が可能となっており、selectedXPathで要素を指定した場合、選択されたボタンの個数分だけ要素を並べることによって複数のボタンが選択された状態を表します。各要素の内容はボタンの識別値です。この場合に限って、selectedXPathで単純要素の集合を指定できます。ただし、すべて同じ要素名である必要があります。データ更新時には選択されたボタンの個数を超える要素は削除され、不足分は追加されます。なお、複数選択が不可能な状態でselectedXPathに集合を指定した場合の動作は、“7.6.3 要素や属性の集合を指定した場合の動作”を参照してください。

    (*1) 要素の集合または属性の集合を指定した場合の動作は“7.6.3 要素や属性の集合を指定した場合の動作”を参照してください。

    (*2) 要素の内容または属性の値に改行が含まれる場合、改行の直前までが使用されます。

使用例

  • 複数選択を許可しない場合

    XML

    <root>
  <selected>soccer</selected>
  <buttonlist>
    <button value="baseball">野球</button>
    <button value="soccer">サッカー</button>
    <button value="tennis">テニス</button>
  </buttonlist>
</root>

    JSP

    <uji:buttonList bean="body" xpath="buttonlist"
                selectedXPath="selected" valueAttr="value"
                multipleMode="false" />

    表示画面

  • 複数選択を許可する場合

    XML

    <root>
  <selected>baseball</selected>
  <selected>soccer</selected>
  <buttonlist>
    <button value="baseball">野球</button>
    <button value="soccer">サッカー</button>
    <button value="tennis">テニス</button>
  </buttonlist>
</root>

    JSP

    <uji:buttonList bean="body" xpath="buttonlist"
                selectedXPath="selected" valueAttr="value"
                multipleMode="true" />

    表示画面

イベントモデル

uji:buttonListタグは、ボタンリストを作成します。

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

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

アトリビュート

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

アトリビュート名

省略

意味

省略時の動作

bean

可

managed beanの名前を指定します。

画面部品タグのカレントオブジェクトを使用します。

property

可

managed beanのプロパティ名を指定します。

managed bean自体がButtonListModelインタフェースを持つオブジェクトとして使用されます。

id

可

コンポーネントのIDを指定します。

自動的に付与されます。

immediate

可

値の検証を処理するフェーズを指定します。

  • trueの場合、Apply Request Valuesで処理されます。

  • falseの場合、Process Validatorsで処理されます。

false

valueChangeListener

可

バリューチェンジリスナメソッドをメソッドバインディング式で指定します。

バリューチェンジリスナメソッドを使用しません。

コンテント

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

  • f:valueChangeListener(0個以上)

使用例

JSP

<f:view>
  <uji:form name="myform" method="post">
    <uji:buttonList bean="body" property="button"
            columns="4" width="120" />
  </uji:form>
</f:view>
注意事項

注意事項については、“基本機能”を参照してください。

ブラウザ対応状況

アトリビュート

IE5.5

IE6

IE7

IE8

Firefox2.0

Firefox3.0

Safari2.0

width

○

○

○

○

○

○

×

height

○

○

○

○

○

○

○

borderColor

○

○

○

○

○

○

○

borderType

○

○

○

○

○

○

○

borderWidth

○

○

○

○

○

○

○

insets

×

×

×

×

○

○

○

background

○

○

○

○

○

○

○

foreground

○

○

○

○

○

○

○

fontStyle

○

○

○

○

○

○

○

fontWeight

○

○

○

○

○

○

○

fontSize

○

○

○

○

○

○

×

textDecoration

※1

※1

※1

※1

○

○

○

enabled

○

○

○

○

○

○

○

columns

○

○

○

○

○

○

○

multipleMode

○

○

○

○

○

○

○

css

※2

※2

※2

※2

※2

※2

※2

visible

○

○

○

○

○

○

○

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

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

前次
Copyright FUJITSU LIMITED 2000-2009