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

apex:pageBlockSection

標準の Salesforce ページレイアウト定義内のセクションに類似した、<apex:pageBlock> コンポーネント内のデータのセクションです。

<apex:pageBlockSection> コンポーネントは、1 つ以上の列で構成されており、各列には、項目の表示ラベルとその値の 2 つのセルがあります。<apex:pageBlockSection> の本文に含まれる各コンポーネントは、列数に達するまで、行の次のセルに配置されます。列数に達したら、その次のコンポーネントは次の行の最初のセルに配置されます。

Salesforce オブジェクトから <apex:pageBlockSection> に項目を追加するには、<apex:inputField> または <apex:outputField> コンポーネントを使用します。各コンポーネントは、項目の関連付けられた表示ラベルと共に自動的に表示されます。Salesforce オブジェクトの項目に基づかない変数またはメソッドの項目を追加する、または Salesforce オブジェクト項目の表示ラベルの形式をカスタマイズするには、<apex:pageBlockSectionItem> コンポーネントを使用します。<apex:inputField><apex:outputField>、または <apex:pageBlockSectionItem> の各コンポーネントは、1 つの列の 2 つのセルにまたがって配置されます。

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

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
8<!-- Page: -->
9<apex:page standardController="Account">
10    <apex:form>
11        <apex:pageBlock title="My Content" mode="edit">
12            <apex:pageBlockButtons>
13                <apex:commandButton action="{!save}" value="Save"/>
14            </apex:pageBlockButtons>
15            <apex:pageBlockSection title="My Content Section" columns="2">
16                <apex:inputField value="{!account.name}"/>
17                <apex:inputField value="{!account.site}"/>
18                <apex:inputField value="{!account.type}"/>
19                <apex:inputField value="{!account.accountNumber}"/>
20            </apex:pageBlockSection>
21        </apex:pageBlock>
22    </apex:form>
23</apex:page>

属性

属性名 属性型 説明 必須かどうか API バージョン 通用範囲
collapsible Boolean ユーザーがページブロックセクションを展開したり折りたたんだりできるかどうかを指定する boolean 値。true の場合、ユーザーはセクションの展開および折りたたみを実行できます。指定されていない場合、この値はデフォルトの true に設定されます。 11.0 グローバル
columns Integer ページブロックセクションの単一の行に含めることができる列の数。単一の列は 2 つのセル (項目の表示ラベルおよびその値) にまたがります。pageBlockSection に子 inputField、子 outputField、または子 pageBlockSectionItem コンポーネントを使用する場合、それぞれの子コンポーネントは、1 つの列の両方のセルにまたがって表示されます。pageBlockSection に他のコンポーネントを使用する場合は、列の一番右のセルにのみ表示され、一番左のセルは空のままになります。pageBlockSection には 1 つ以上の列を指定できますが、Salesforce スタイルシートは 1 つまたは 2 つの列に対して最適化されています。指定されていない場合、この値はデフォルトの 2 に設定されます。 11.0 グローバル
dir String 生成された HTML コンポーネントの読み取り方向。可能な値には「RTL」 (右から左) または「LTR」 (左から右) などがあります。 10.0 グローバル
id String ページの他のコンポーネントが pageBlockSection コンポーネントを参照できるようにする識別子。 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 グローバル
showHeader Boolean ページブロックセクションのタイトルを表示するかどうかを指定する boolean 値。true に設定すると、ヘッダーが表示されます。指定されていない場合、この値はデフォルトの true に設定されます。 11.0 グローバル
title String ページブロックセクションのタイトルとして表示されるテキスト。 10.0 グローバル

ファセット

ファセット名 説明 API バージョン
body ページブロックセクションの本文に表示されるコンポーネント。指定されている場合、このファセットのコンテンツが、pageBlockSection タグの本文より優先されます。セクション本文の表示は、name="body" を含むファセットによって制御されるため、body ファセットがページブロックセクションコンポーネントの本文に表示される順序は重要ではありません。 11.0
header ページブロックセクションのタイトルに表示されるコンポーネント。指定されている場合、このファセットのコンテンツが、タイトル属性の値より優先されます。セクションタイトルの表示は、name="header" を含むファセットによって制御されるため、header ファセットがページブロックセクションコンポーネントの本文に表示される順序は重要ではありません。 10.0