この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

apex:pageBlockTable

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

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

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

Salesforce.com 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>

属性

属性名 属性型 説明 必須項目 API バージョン アクセス
align String 表示される HTML テーブルのページに対する位置。使用できる値には、「left」、「center」、または「right」があります。指定されていない状態にすると、この値はデフォルトの「left」に設定されます。 12.0 global
bgcolor String この属性は Salesforce API バージョン 18.0 では使用できなくなりました。ページへの影響はありません。 12.0 global
border String 表示される HTML テーブルの周囲のフレームの幅 (ピクセル単位)。 12.0 global
captionClass String caption facet が指定されている場合、表示される HTML テーブルのキャプションの表示に使用されるスタイルクラス。この属性は、主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 12.0 global
captionStyle String caption facet が指定されている場合、表示される HTML テーブルのキャプションの表示に使用されるスタイル。この属性は、主に、インライン CSS スタイルを追加するために使用されます。 12.0 global
cellpadding String 各リストのセルの境界線とセルのコンテンツの間のスペース。この属性の値がピクセル単位の長さである場合、4 辺の余白のすべてでコンテンツからの距離がこの値に設定されます。属性の値がパーセント単位の長さである場合は、上下の余白は利用可能な縦方向のスペースのパーセントに基づいてコンテンツからの距離が上下均等の長さに分割され、左右の余白は利用可能な横方向のスペースのパーセントに基づいてコンテンツからの距離が左右均等の長さに分割されます。 12.0 global
cellspacing String 各リストのセルの境界線とそのセルを取り囲む他のセルの境界線および/またはリストの端の間のスペース。この値はピクセルまたはパーセント単位で指定する必要があります。 12.0 global
columnClasses String リストの列に関連付けられた 1 つ以上のクラスのカンマ区切りのリスト。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。複数のクラスが指定されている場合、クラスはすべての列に繰り返し適用されます。たとえば、columnClasses="classA, classB" と指定すると、最初の列は classA でスタイル設定され、2 番目の列は classB でスタイル設定され、3 番目の列は classA でスタイル設定され、4 番目の列は classB でスタイル設定されます (以下同様)。 12.0 global
columns Integer このページブロックテーブルの列の数。 12.0 global
columnsWidth String 各リストの列に適用される幅のカンマ区切りのリスト。値はピクセルで表す���とができます (columnsWidth="100px, 100px" など)。 12.0 global
dir String 生成された HTML コンポーネントの読み取り方向。使用可能な値には「RTL」(右から左) または「LTR」(左から右) があります。 12.0 global
first Integer ページブロックテーブルに視覚的に表示される反復処理の最初の要素。ここで、0 は value 属性で指定されている一連のデータの最初の要素のインデックスです。たとえば、value 属性で指定されている一連のレコードの最初の 2 つの要素を表示しない場合は、first="2" と設定します。 12.0 global
footerClass String footer facet が指定されている場合、表示される HTML テーブルのフッター (一番下の行) を表示するために使用されるスタイルクラス。この属性は、主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 12.0 global
frame String このページブロックテーブルに引かれる境界線。使用できる値には、「none」、「above」、「below」、「hsides」、「vsides」、「lhs」、「rhs」、「box」、および「border」があります。指定されていない場合、この値はデフォルトの「border」に設定されます。 12.0 global
headerClass String header facet が指定されている場合、表示される HTML テーブルのヘッダーの表示に使用されるスタイルクラス。この属性は、主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 12.0 global
id String ページの他のコンポーネントが pageBlockTable コンポーネントを参照できるようにする識別子。 12.0 global
lang String 「en」または「en-US」など、生成された HTML 出力の基本言語。この属性についての詳細は、W3C 仕様を参照してください。 12.0 global
onclick String onclick イベントが発生した場合 (ユーザがページブロックテーブルをクリックした場合) に呼び出される JavaScript。 12.0 global
ondblclick String ondblclick イベントが発生した場合 (ユーザがページブロックテーブルをダブルクリックした場合) に呼び出される JavaScript。 12.0 global
onkeydown String onkeydown イベントが発生した場合 (ユーザがキーボードのキーを押した場合) に呼び出される JavaScript。 12.0 global
onkeypress String onkeypress イベントが発生した場合 (ユーザがキーボードのキーを押したか、押したままにした場合) に呼び出される JavaScript。 12.0 global
onkeyup String onkeyup イベントが発生した場合 (ユーザがキーボードのキーを放した場合) に呼び出される JavaScript。 12.0 global
onmousedown String onmousedown イベントが発生した場合 (ユーザがマウスボタンをクリックした場合) に呼び出される JavaScript。 12.0 global
onmousemove String onmousemove イベントが発生した場合 (ユーザがマウスポインタを移動した場合) に呼び出される JavaScript。 12.0 global
onmouseout String onmouseout イベントが発生した場合 (ユーザがページブロックテーブルからマウスポインタを移動した場合) に呼び出される JavaScript。 12.0 global
onmouseover String onmouseover イベントが発生した場合 (ユーザがページブロックテーブルにマウスポインタを重ねた場合) に呼び出される JavaScript。 12.0 global
onmouseup String onmouseup イベントが発生した場合 (ユーザがマウスボタンを放した場合) に呼び出される JavaScript。 12.0 global
onRowClick String onRowClick イベントが発生した場合 (ユーザがページブロックテーブルの行をクリックした場合) に呼び出される JavaScript。 12.0 global
onRowDblClick String onRowDblClick イベントが発生した場合 (ユーザがページブロックリストテーブルの行をクリックした場合) に呼び出される JavaScript。 12.0 global
onRowMouseDown String onRowMouseDown イベントが発生した場合 (ユーザがページブロックテーブルの行でマウスボタンをクリックした場合) に呼び出される JavaScript。 12.0 global
onRowMouseMove String onRowMouseMove イベントが発生した場合 (ユーザがマウスポインタをページブロックテーブルの行に重ねた場合) に呼び出される JavaScript。 12.0 global
onRowMouseOut String onRowMouseOut イベントが発生した場合 (ユーザがページブロックテーブルの行からマウスポインタを移動した場合) に呼び出される JavaScript。 12.0 global
onRowMouseOver String onRowMouseOver イベントが発生した場合 (ユーザがページブロックテーブルの行にマウスポインタを重ねた場合) に呼び出される JavaScript。 12.0 global
onRowMouseUp String onRowMouseUp イベントが発生した場合 (ユーザがページブロックテーブルの行の上でマウスボタンを放した場合) に呼び出される JavaScript。 12.0 global
rendered Boolean コンポーネントをページに表示するかどうかを指定する boolean 値。指定されていない場合、この値はデフォルトの true に設定されます。 12.0 global
rowClasses String ページブロックテーブルの行に関連付けられた 1 つ以上のクラスのカンマ区切りのリスト。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。複数のクラスが指定されている場合、それらのクラスがすべての行に繰り返し適用されます。たとえば、columnRows="classA, classB" と指定すると、最初の行は classA でスタイル設定され、2 番目の行は classB でスタイル設定され、3 番目の行は classA でスタイル設定され、4 番目の行は classB でスタイル設定されます (以下同様)。 12.0 global
rows Integer このページブロックテーブルの行の数。 12.0 global
rules String ページブロックテーブルのセルの間に引かれる境界線。使用できる値には、「none」、「groups」、「rows」、「cols」、および「all」があります。指定されていない場合、この値はデフォルトの「none」に設定されます。 12.0 global
style String pageBlockTable コンポーネントの表示に使用されるスタイル。主に、インライン CSS スタイルを追加するために使用されます。 12.0 global
styleClass String pageBlockTable コンポーネントの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 12.0 global
summary String セクション 508 の準拠に関するページブロックテーブルの目的と構造の概要。 12.0 global
title String ユーザがコンポーネントにマウスポインタを重ねたときにツールチップとして表示されるテキスト。 12.0 global
value Object ページブロックテーブルに表示されるデータのコレクション。 はい 12.0 global
var String value 属性で指定するデータのコレクションの 1 つの要素を表す変数の名前。この変数を使用して、pageBlockTable コンポーネントタグの本文に要素自体を表示することができます。 はい 12.0 global
width String pageBlockTable 全体の幅。利用可能な横方向の合計スペースに対する相対パーセント (width="80%" など)、またはピクセル数 (width="800px" など) のいずれかで表されます。 12.0 global

Facet

facet 名 説明 API バージョン
caption ページブロックテーブルのキャプションに表示されるコンポーネント。テーブルのキャプションの表示は、name="caption" を含む facet によって制御されるため、caption facet が pageBlockTable コンポーネントの本文に表示される順序は重要ではありません。 12.0
footer ページブロックテーブルのフッター行に表示されるコンポーネント。テーブルの最終行の表示は、name="footer" を含む facet によって制御されるため、footer facet が pageBlockTable コンポーネントの本文に表示される順序は重要ではありません。 12.0
header ページブロックテーブルのヘッダー行に表示されるコンポーネント。テーブルの冒頭行の表示は、name="header" を含む facet によって制御されるため、header facet が pageBlockTable コンポーネントの本文に表示される順序は重要ではありません。 12.0