JSF HTMLライブラリ - <h:dataTable>タグ

ページにデータ表を作成します。コンポーネントはHTML <table>要素としてレンダリングされ、UIColumn子コンポーネントが表列のレンダリングを行います。列には、入力やコマンドなど、任意のタイプのコンポーネントを保持できます。value属性値には任意のタイプを設定できますが、主要なモデル・タイプはjavax.faces.model.DataModelクラスです。

データ表コンポーネントとその列の子コンポーネントには、headerおよびfooterファセットを設定できます。表のheaderファセットは、<thead>要素に囲まれた、<tr>要素内の1つの<th>要素としてレンダリングされます。footerファセットも同様にレンダリングされますが、<tfoot>要素に囲まれた<td>要素内にレンダリングされます。

表の行は<tbody>要素内にレンダリングされ、各行に<tr>要素、各列の子に<td>要素があります。レンダリングする最初の行、およびレンダリングする行数は、first属性とrows属性で指定できます。

構文

<h:dataTable
	[id="id"]
	[binding="componentBinding"]
	[rendered="true|false"]
	[value="value"]
	[var="var"]
	[first="first"]
	[rows="numberRows"]
	[headerClass="styleClass"]
	[footerClass="styleClass"]
	[rowClasses="styleClasses"]
	[columnClasses="styleClasses"]
	<!--HTML attributes-->
>
	[<f:facet name="header">...</facet>]
	[<f:facet name="footer">...</facet>]
	<h:column>
	JSF action components
	</h:column>
/h:dataTable>    

説明

id
文字列。このコンポーネントのコンポーネント識別子。値は、ネーミング・コンテナである最も近い親コンポーネント内で一意である必要があります。
rendered
ブール値。レンダー・レスポンス・フェーズ中にこのコンポーネントをレンダリングするかどうか、または後続のフォーム発行でこのコンポーネントを処理するかどうかを示すフラグ。
binding
文字列。このコンポーネントをバッキングBeanのプロパティにリンクする値バインディング式。
value
オブジェクト。このコンポーネントの現在の値。
var
文字列。rowIndexプロパティの現在の値、またはrowDataプロパティの現在の値によって選択された行について、データ・モデルを公開するリクエスト・スコープ属性の名前。
first
整数。表示される最初の行のゼロ相対番号行。このプロパティを0(ゼロ)に設定すると、基礎となるデータの最初の行からレンダリングされます。
rows
整数。表示される行数で、firstプロパティで識別された行から表示されます。この値を0(ゼロ)に設定すると、基礎となるデータ・モデルのすべての行が表示されます。
headerClass
文字列。この表で生成されたヘッダーに適用されるCSSスタイル・クラスのスペース区切りのリスト。
footerClass
文字列。この表で生成されたフッターに適用されるCSSスタイル・クラスのスペース区切りのリスト。
rowClasses
文字列。この表の行に適用されるCSSスタイル・クラスのカンマ区切りのリスト。各行ではクラスのスペース区切りのリストも指定できます。これらのクラスは表の各行に適用されます。たとえば、このリストに2つのスタイルを指定した場合は、最初の行にリスト内の1番目のスタイル・クラスが適用され、2行目には2番目のスタイル、3行目には1番目のスタイル、4行目には2番目のスタイルのように適用されます。リストは最後に達すると反復され、後続の行に繰返し適用されます。
columnClasses
文字列。この表の列に適用されるCSSスタイル・クラスのカンマ区切りのリスト。各列ではクラスのスペース区切りのリストも指定できます。columns属性で指定された列数よりこのテストの要素数が少ない場合、リスト内の要素数を超える行ではclass属性が出力されません。columns属性で指定された列数より要素数が多い場合、リスト内でcolumns属性の値を超える位置にある要素は無視されます。

JSFでサポートされているHTML 4.01属性(オプション)については、「JSF標準コンポーネントのタグ属性の概要」を参照してください。

このタグおよびすべてのJSF Core要素とHTML要素の詳細は、次のURLの「W3C JavaServer Faces 1.1 Specification」を参照してください。
http://java.sun.com/j2ee/javaserverfaces/1.1/docs/tlddocs/index.html


リファレンス: JSF標準コンポーネント