apex:column
テーブルの単一の列です。<apex:column> コンポーネントは必ず <apex:dataTable> または <apex:pageBlockTable> コンポーネントの子である必要があります。
sObject 項目を <apex:column> の value 属性として指定すると、その項目に関連付けられている表示ラベルがデフォルトで列ヘッダーとして使用されます。この動作を上書きするには、列の headerValue 属性か、または列の header ファセットを使用します。
このコンポーネントでは、「html-」プレフィックスを使用した HTML パススルー属性がサポートされています。パススルー属性は、テーブルのすべての行の列に対して生成された <td> タグに適用されます。
例
1<!-- For this example to render properly, you must associate the Visualforce page
2with a valid account record in the URL.
3For example, if 001D000000IRt53 is the account ID, the resulting URL should be:
4https://Salesforce_instance/apex/myPage?id=001D000000IRt53
5See the Visualforce Developer's Guide Quick Start Tutorial for more information. -->
6
7<apex:page standardController="Account">
8 <apex:pageBlock title="My Content">
9 <apex:pageBlockTable value="{!account.Contacts}" var="item">
10 <apex:column value="{!item.name}"/>
11 <apex:column value="{!item.phone}"/>
12 </apex:pageBlockTable>
13 </apex:pageBlock>
14</apex:page>属性
| 属性名 | 属性型 | 説明 | 必須かどうか | API バージョン | 通用範囲 |
|---|---|---|---|---|---|
| breakBefore | Boolean | 列がテーブルで新しい行を開始するかどうかを指定する boolean 値。true に設定されている場合、列が新しい行を開始します。指定されていない場合、この値はデフォルトの false に設定されます。 | 10.0 | グローバル | |
| colspan | Integer | この列がテーブルでまたぐ列の数。この値はヘッダーセルおよびフッターセルには適用されません。 | 10.0 | グローバル | |
| dir | String | 生成された列のテキストの読み取り方向。使用可能な値には「RTL」 (右から左) または「LTR」 (左から右) があります。この値はヘッダーセルおよびフッターセルには適用されません。 | 10.0 | グローバル | |
| footerClass | String | 列フッターの表示に使用されるスタイルクラス (定義されている場合)。この属性は、主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 | 10.0 | グローバル | |
| footercolspan | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| footerdir | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| footerlang | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| footeronclick | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| footerondblclick | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| footeronkeydown | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| footeronkeypress | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| footeronkeyup | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| footeronmousedown | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| footeronmousemove | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| footeronmouseout | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| footeronmouseover | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| footeronmouseup | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| footerstyle | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| footertitle | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| footerValue | String | 列フッターに表示されるテキスト。この属性の値を指定すると、列の footer ファセットを使用できません。 | 12.0 | グローバル | |
| headerClass | String | テーブルヘッダーの表示に使用されるスタイルクラス (定義されている場合)。この属性は、主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 | 10.0 | グローバル | |
| headercolspan | String | このヘッダー列がテーブルでまたぐ列の数 (定義されている場合)。この属性は Visualforce ページのバージョン 16.0 以降では使用できません。 | 10.0 | グローバル | |
| headerdir | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| headerlang | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| headeronclick | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| headerondblclick | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| headeronkeydown | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| headeronkeypress | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| headeronkeyup | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| headeronmousedown | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| headeronmousemove | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| headeronmouseout | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| headeronmouseover | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| headeronmouseup | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| headerstyle | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| headertitle | String | この属性は Salesforce API バージョン 16.0 では使用できなくなりました。ページへの影響はありません。 | 10.0 | グローバル | |
| headerValue | String | 列ヘッダーに表示されるテキスト。この属性の値を指定すると、列の header ファセットを使用できません。この属性の値を指定することで、列本文の inputField または outputField を使用する場合に表示されるデフォルトのヘッダーラベルが上書きされます。 | 12.0 | グローバル | |
| id | String | ページの他のコンポーネントが列コンポーネントを参照できるようにする識別子。 | 10.0 | グローバル | |
| lang | String | 「en」または「en-US」など、生成された HTML 出力の基本言語。この属性についての詳細は、W3C 仕様を参照してください。 | 10.0 | グローバル | |
| onclick | String | 列で onclick イベントが発生した場合 (列をクリックした場合) に呼び出される JavaScript。この値はヘッダーセルおよびフッターセルには適用されません。 | 10.0 | グローバル | |
| ondblclick | String | 列で ondblclick イベントが発生した場合 (列を���ブルクリックした場合) に呼び出される JavaScript。この値はヘッダーセルおよびフッターセルには適用されません。 | 10.0 | グローバル | |
| onkeydown | String | 列で onkeydown イベントが発生した場合 (ユーザがキーボードのキーを押した場合) に呼び出される JavaScript。この値はヘッダーセルおよびフッターセルには適用されません。 | 10.0 | グローバル | |
| onkeypress | String | 列で onkeypress イベントが発生した場合 (ユーザがキーボードのキーを押したか、押したままにした場合) に呼び出される JavaScript。この値はヘッダーセルおよびフッターセルには適用されません。 | 10.0 | グローバル | |
| onkeyup | String | 列で onkeyup イベントが発生した場合 (ユーザがキーボードのキーを放した場合) に呼び出される JavaScript。この値はヘッダーセルおよびフッターセルには適用されません。 | 10.0 | グローバル | |
| onmousedown | String | 列で onmousedown イベントが発生した場合 (ユーザがマウスボタンをクリックした場合) に呼び出される JavaScript。この値はヘッダーセルおよびフッターセルには適用されません。 | 10.0 | グローバル | |
| onmousemove | String | 列で onmousemove イベントが発生した場合 (ユーザがマウスポインタを移動した場合) に呼び出される JavaScript。この値はヘッダーセルおよびフッターセルには適用されません。 | 10.0 | グローバル | |
| onmouseout | String | 列で onmouseout イベントが発生した場合 (ユーザが列からマウスポインタを移動した場合) に呼び出される JavaScript。この値はヘッダーセルおよびフッターセルには適用されません。 | 10.0 | グローバル | |
| onmouseover | String | 列で onmouseover イベントが発生した場合 (ユーザがマウスポインタを列に重ねた場合) に呼び出される JavaScript。この値はヘッダーセルおよびフッターセルには適用されません。 | 10.0 | グローバル | |
| onmouseup | String | 列で onmouseup イベントが発生した場合 (ユーザがマウスボタンを放した場合) に呼び出される JavaScript。この値はヘッダーセルおよびフッターセルには適用されません。 | 10.0 | グローバル | |
| rendered | Boolean | コンポーネントをページに表示するかどうかを指定する boolean 値。指定されていない場合、この値はデフォルトの true に設定されます。 | 10.0 | グローバル | |
| rowspan | Integer | この列の各セルがテーブルで占める行の数。 | 10.0 | グローバル | |
| style | String | 列の表示に使用されるスタイル。主に、インライン CSS スタイルを追加するために使用されます。この値はヘッダーセルおよびフッターセルには適用されません。 | 10.0 | グローバル | |
| styleClass | String | 列の表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。この値はヘッダーセルおよびフッターセルには適用されません。 | 10.0 | グローバル | |
| title | String | ユーザがコンポーネントにマウスポインタを重ねたときにツールチップとして表示されるテキスト。 | 10.0 | グローバル | |
| value | String | ヘッダーセルおよびフッターセル以外ですべての列のセルに表示されるテキスト。この属性の値を指定すると、列の開始タグおよび終了タグの間にコンテンツを追加することはできません。 | 12.0 | グローバル | |
| width | String | 列のピクセル (px) またはパーセント (%) 単位の幅。指定されていない場合、この値はデフォルトの 100 ピクセルに設定されます。 | 10.0 | グローバル |
ファセット
| ファセット名 | 説明 | API バージョン |
|---|---|---|
| footer | 列のフッターセルに表示されるコンポーネント。列の最後のセルの表示は、name="footer" を含むファセットによって制御されるため、footer ファセットが列コンポーネントの本文に表示される順序は重要ではありません。footer ファセットを使用する場合、列の footerValue 属性の値を指定できません。 | 10.0 |
| header | 列のヘッダーセルに表示されるコンポーネント。列の最初のセルの表示は、name="header" を含むファセットによって制御されるため、header ファセットが列コンポーネントの本文に表示される順序は重要ではありません。header ファセットを使用する場合、列の headerValue 属性の値を指定できません。このファセットの値を指定することで、列本文の inputField または outputField を使用する場合に表示されるデフォルトのヘッダー表示ラベルが上書きされます。 | 10.0 |