基本機能
uji:checkBoxタグは、チェックボックスを作成します。
beanとpropertyで指定されたデータBeanのプロパティに対応して、データを表示・入力します。指定されたデータがCheckBoxModelインタフェースを持つ場合は、データBean側で文字色などのいくつかの書式を指定することができます。データBean側とアトリビュートと双方で書式を設定した場合は、データBeanの指定が優先されます。 CheckBoxModelインタフェースの代わりに外付け属性を利用する方法については、“Apcoordinatorユーザーズガイド”を参照してください。
uji:checkBoxタグは、HTMLのFORMタグまたはuji:formタグの中に記述します。
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属性を設定します。 | class属性を出力しません。 |
visible | 可 | 項目の表示の有無をtrue/falseで指定します。 | true |
event | 可 | イベント発生時に実行するJavaScriptを記述します。 | イベント発生時にJavaScriptを実行しません。 |
(*)“7.5.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.4.1 使用するXML要素の指定方法”を参照してください。
propertyまたはxpathは単純要素を指定します(*1)。
propertyまたはxpath指定した要素の内容が"true"（大文字小文字は区別しません）の場合チェック状態となります。
(*1) 要素の集合を指定した場合の動作は“7.4.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 | 可 | 値の変換と検証を処理するフェーズを指定します。
| 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>注意事項については、“基本機能”を参照してください。
ブラウザ対応状況
アトリビュート | IE7 | IE8 | IE9 | IE10 | IE11 |
|---|---|---|---|---|---|
width | ※1 | ※1 | ※1 | ○ | ○ |
height | ※1 | ※1 | ※1 | ○ | ○ |
borderColor | ○ | ○ | ○ | ○ | ○ |
borderType | ○ | ○ | ○ | ○ | ○ |
borderWidth | ※2 | ※2 | ○ | ○ | ○ |
background | ○ | ○ | ○ | ○ | ○ |
foreground | ○ | ○ | ○ | ○ | ○ |
fontStyle | ○ | ○ | ○ | ○ | ○ |
fontWeight | ○ | ○ | ○ | ○ | ○ |
fontSize | ○ | ○ | ○ | ○ | ○ |
textDecoration | ※3 | ※3 | ※3 | ※3 | ※3 |
enabled | ○ | ○ | ○ | ○ | ○ |
verticalAlignment | ※4 | ※4 | ※4 | ※4 | ※4 |
tabIndex | ○ | ○ | ○ | ○ | ○ |
tipText | ○ | ○ | ○ | ○ | ○ |
label | ○ | ○ | ○ | ○ | ○ |
css | ※5 | ※5 | ※5 | ※5 | ※5 |
visible | ○ | ○ | ○ | ○ | ○ |
※1: 幅または高さの小さいサイズにそった正方形のチェックボックスとなります。
※2: 実数値＋単位は、指定不可です。
※3: blinkは指定できません。
※4: ベースラインから下へのスペース指定です。
※5: CSSを使った設定が実際に表示に反映されるかどうかはブラウザの仕様に依存します。