apex:pageBlockTable

標準の Salesforce ページの関連リストまたはリストビューに類似した、<apex:pageBlock> コンポーネントまたは <apex:pageBlockSection> コンポーネントのいずれかにテーブルとして表示されるデータのリストです。<apex:dataTable> と同様に、<apex:pageBlockTable> は一連のデータを反復することによって定義され、1 行あたり 1 つのデータ項目に関する情報を表示します。一連のデータには最大 1,000 個または 10,000 個 (参照のみモードでページを実行する場合) の項目を含めることができます。

<apex:pageBlockTable> の本文には、テーブルに似た、データの各項目に関して表示する情報を指定する 1 つ以上の列コンポーネントが含まれます。<apex:dataTable> コンポーネントとは異なり、<apex:pageBlockTable> のデフォルトのスタイルは、標準の Salesforce スタイルに一致します。<apex:pageBlockTable> 属性で指定されたその他のスタイルは、標準の Salesforce スタイルに追加されます。

列の value 属性として sObject 項目を指定した場合、デフォルトで、その項目の関連する表示ラベルが列ヘッダーとして使用されます。この動作を上書きするには、列の headerValue 属性か、または列の header ファセットを使用します。

API バージョン 20.0 以降が稼動している Visualforce ページでは、このコンポーネントに <apex:repeat> タグを含めて列を生成できます。

このコンポーネントでは、「html-」プレフィックスを使用した HTML パススルー属性がサポートされています。パススルー属性は、生成されたテーブルの <tbody> タグに適用されます。

1<!-- For this example to render properly, you must associate the Visualforce page
2
3with a valid account record in the URL.
4
5For example, if 001D000000IRt53 is the account ID, the resulting URL should be:
6
7https://Salesforce_instance/apex/myPage?id=001D000000IRt53
8
9See the Visualforce Developer's Guide Quick Start Tutorial for more information. -->
10
11
12
13
14
15<!-- Page: -->
16
17<apex:page standardController="Account">
18
19    <apex:pageBlock title="My Content">
20
21        <apex:pageBlockTable value="{!account.Contacts}" var="item">
22
23            <apex:column value="{!item.name}"/>
24
25        </apex:pageBlockTable>
26
27    </apex:pageBlock>
28
29</apex:page>