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