5.9 uji:checkBox

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

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

ブラウザ対応状況

基本機能

uji:checkBoxタグは、チェックボックスを作成します。

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

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

アトリビュート

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

アトリビュート名	省略	意味	省略時の動作
bean	可	データBeanのJSP変数名を指定します。	画面部品タグのカレントオブジェクトを使用します。
property	可	データBeanのプロパティ名を指定します。	データBean自体がCheckBoxModelインタフェースを持つオブジェクトとして使用されます。
width	可	フィールドの幅を指定します。(*)	標準の幅となります。
height	可	フィールドの高さを指定します。(*)	標準の高さとなります。
borderColor	可	フィールド枠の色を指定します。(*)	標準の色となります。
borderType	可	フィールド枠の形式を指定します。(*)	標準の形式となります。
borderWidth	可	フィールド枠の線幅を指定します。(*)	標準の線幅となります。
background	可	フィールドの背景色を指定します。(*)	標準の背景色となります。
foreground	可	文字色を指定します。(*)	標準の文字色となります。
fontStyle	可	文字スタイルを指定します。(*)	標準の文字スタイルとなります。
fontWeight	可	文字の太さを指定します。(*)	標準の太さとなります。
fontSize	可	文字の大きさを指定します。(*)	標準の大きさとなります。
textDecoration	可	文字の装飾形式を指定します。(*)	標準の装飾形式となります。
enabled	可	項目の操作の可否をtrue/falseで指定します。	true
verticalAlignment	可	フィールドの縦位置合わせ方法を指定します。(*)	標準値となります。
tabIndex	可	タブ順を数値で指定します。	配置順となります。
tipText	可	マウスポイント時に表示するティップの文字列を指定します。	表示しません。
label	可	ラベルテキストを指定します。	表示しません。
css	可	class属性の属性値を指定します。以下のタグにclass属性を設定します。 INPUT, LABEL	class属性を出力しません。
visible	可	項目の表示の有無をtrue/falseで指定します。	true
event	可	イベント発生時に実行するJavaScriptを記述します。	イベント発生時にJavaScriptを実行しません。

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

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

使用例

JSP

<uji:checkBox bean="body" property="checkData"
        foreground="green" />

注意事項

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

XML連携機能

uji:checkBoxはチェックボックスを作成します。uji:checkBoxタグは以下の動作をします。

beanが保持するXMLツリーからpropertyまたはxpathで指定された要素の内容に従ってチェックボックスのチェック状態を表示します。

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

アトリビュート

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

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

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

XMLデータの構造

propertyまたはxpathは単純要素を指定します(*1)。
propertyまたはxpath指定した要素の内容が"true"（大文字小文字は区別しません）の場合チェック状態となります。
(*1) 要素の集合を指定した場合の動作は“7.6.3 要素や属性の集合を指定した場合の動作”を参照してください。

使用例

XML

<root>
  <order>
    <no>1</no>
    <name>米酢</name>
    <check>true</check>
  </order>
</root>

JSP

<uji:checkBox bean="body" xpath="order/check" label="米酢"/>

表示画面

イベントモデル

uji:checkBoxタグは、チェックボックスを作成します。

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

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

アトリビュート

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

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

コンテント

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

f:valueChangeListener(0個以上)

使用例

JSP

 <f:view>
  <uji:form name="myform">
    <uji:checkBox bean="myBean" property="checkData"
             foreground="green" />
  </uji:form>
</f:view>

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

ブラウザ対応状況

アトリビュート	IE5.5	IE6	IE7	IE8	Firefox2.0	Firefox3.0	Safari2.0
width	※1	※1	※1	※1	※1	※1	※2
height	※1	※1	※1	※1	※1	※1	×
borderColor	○	○	○	○	×	×	×
borderType	○	○	○	○	×	×	×
borderWidth	※3	※3	※3	※3	×	×	×
background	○	○	○	○	×	×	×
foreground	×	○	○	○	○	○	○
fontStyle	○	○	○	○	○	○	○
fontWeight	○	○	○	○	○	○	○
fontSize	○	○	○	○	○	○	○
textDecoration	※4	※4	※4	※4	○	○	※4
enabled	○	○	○	○	○	○	○
verticalAlignment	※5	※5	※5	※5	○	○	×
tabIndex	○	○	○	○	○	○	×
tipText	○	○	○	○	○	○	○
label	○	○	○	○	○	○	○
css	※6	※6	※6	※6	※6	※6	※6
visible	○	○	○	○	○	○	○

※1: 幅または高さの小さいサイズにそった正方形のチェックボックスとなります。

※2: widthはチェックボックス、ラジオボタンとその右側の余白を含めた領域に適用されます。チェックボックス、ラジオボタンのサイズは固定です。

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

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

※5: ベースラインから下へのスペース指定です。

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