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

<apex:composition> を使用したテンプレートの定義

<apex:composition> を使用して定義したすべてのテンプレートには、1 つ以上の子の <apex:insert> タグが必要です。<apex:insert> タグは、そのテンプレートをインポートするページに対し、そのセクションで定義が必要であることを示します。<apex:composition> を使用してテンプレートをインポートする Visualforce ページでは、<apex:define> を使用してテンプレートの各 <apex:insert> セクションのコンテンツを指定する必要があります。

スケルトンテンプレートを作成すると、それ以降の Visualforce ページが同じ標準構造内で異なるコンテンツを実装できます。そのためには、<apex:composition> タグを使用してテンプレートページを作成します。

次の例は、<apex:composition>、<apex:insert>、および <apex:define> を使用してスケルトンテンプレートを実装する方法を示します。

最初に、compositionExample というコントローラを使用する myFormComposition という空のページを作成します。

1<apex:page controller="compositionExample">
2
3</apex:page>

ページを保存すると、compositionExample の作成を要求するメッセージが表示されます。次のコードを使用して、そのカスタムコントローラを定義します。

1public class compositionExample{
2
3    String name;
4    Integer age;
5    String meal;
6    String color;
7    
8    Boolean showGreeting = false;
9    
10    public PageReference save() {
11        showGreeting = true;
12        return null;
13    }
14    
15    public void setNameField(String nameField) {
16        name = nameField;
17    }
18    
19    public String getNameField() {
20        return name;
21    }
22    
23    public void setAgeField(Integer ageField) {
24        age= ageField;
25    }
26    
27    public Integer getAgeField() {
28        return age;
29    }
30    
31    public void setMealField(String mealField) {
32        meal= mealField;
33    }
34    
35    public String getMealField() {
36        return meal;
37    }   
38         
39    public void setColorField(String colorField) {
40        color = colorField;
41    }
42    
43    public String getColorField() {
44        return color;
45    }       
46    
47    public Boolean getShowGreeting() {
48        return showGreeting;
49    }
50}

次に、myFormComposition に戻り、スケルトンテンプレートを作成します。

1<apex:page controller="compositionExample">
2    <apex:form >
3        <apex:outputLabel value="Enter your name: " for="nameField"/>
4        <apex:inputText id="nameField" value="{!nameField}"/>
5        <br />
6        <apex:insert name="age" />
7        <br />
8        <apex:insert name="meal" />
9        <br />      
10        <p>That's everything, right?</p>
11        <apex:commandButton action="{!save}" value="Save" id="saveButton"/>
12    </apex:form>
13</apex:page>

2 つの <apex:insert> 項目が age と meal のコンテンツを必要としています。これらの項目のマークアップは、この構成テンプレートをコールするすべてのページに定義されます。

次に、myFullForm というページを作成し、そこで myFormComposition に <apex:insert> タグを定義します。

1<apex:page controller="compositionExample">
2    <apex:messages/>
3    <apex:composition template="myFormComposition">
4    
5    <apex:define name="meal">
6        <apex:outputLabel value="Enter your favorite meal: " for="mealField"/>
7        <apex:inputText id="mealField" value="{!mealField}"/>
8    </apex:define>
9
10    <apex:define name="age">
11        <apex:outputLabel value="Enter your age: " for="ageField"/>
12        <apex:inputText id="ageField" value="{!ageField}"/>
13    </apex:define>
14    
15   <apex:outputLabel value="Enter your favorite color: " for="colorField"/>
16   <apex:inputText id="colorField" value="{!colorField}"/>
17    
18    </apex:composition>
19    
20    <apex:outputText id="greeting" rendered="{!showGreeting}" value="Hello {!nameField}. 
21    You look {!ageField} years old. Would you like some {!colorField} {!mealField}?"/>
22</apex:page>

このマークアップでは、次の点に留意してください。

myFullForm を保存すると、前に定義した <apex:inputText> タグと [保存] ボタンが表示されます。
構成ページには age 項目および meal 項目が必要であるため、myFullForm はこれらをテキスト入力項目として定義します。項目がページに表示されている順序は重要ではありません。myFormComposition は age 項目が常に meal 項目よりも前に表示されるように指定します。
一致する <apex:define> 項目がない場合でも、name 項目はインポートされます。
項目のコントローラコードが存在する場合でも、color 項目は無��されます。これは、構成テンプレートが color という名前の項目を必要としないためです。
age および meal 項目は、テキスト入力である必要はありません。<apex:define> タグ内のコンポーネントは、任意の有効な Visualforce タグにすることができます。

<apex:define> タグで有効な Visualforce を使用する方法の例として、myAgelessForm という新規 Visualforce ページを作成して次のマークアップを使用します。

1<apex:page controller="compositionExample">
2    <apex:messages/>
3    <apex:composition template="myFormComposition">
4    
5    <apex:define name="meal">
6        <apex:outputLabel value="Enter your favorite meal: " for="mealField"/>
7        <apex:inputText id="mealField" value="{!mealField}"/>
8    </apex:define>
9
10    <apex:define name="age">
11        <p>You look great for your age!</p>
12    </apex:define>
13
14    </apex:composition>
15    
16    <apex:outputText id="greeting" rendered="{!showGreeting}" value="Hello {!nameField}. 
17    Would you like some delicious {!mealField}?"/>
18</apex:page>

構成テンプレートで必要なのは、<apex:define> タグが存在することだけです。この例では、age がテキストして定義されています。

動的テンプレート

PageReference を介してテンプレートを割り当てるには、動的テンプレートを使用します。テンプレート名は、使用するテンプレートが含まれる PageReference を返すコントローラメソッドに割り当てられます。

たとえば、スケルトンテンプレートを定義する myAppliedTemplate というページを作成します。

1<apex:page>
2    <apex:insert name="name" />
3</apex:page>

次に、このページへの参照を返すメソッドを使用する dynamicComposition というコントローラを作成します。

1public class dynamicComposition {
2    public PageReference getmyTemplate() {
3        return Page.myAppliedTemplate;
4    }
5}

最後に、このコントローラと動的テンプレートを実装する myDynamicComposition というページを作成します。

1<apex:page controller="dynamicComposition">
2    <apex:composition template="{!myTemplate}">
3    <apex:define name="name">
4        Hello {!$User.FirstName}, you look quite well.
5    </apex:define>
6    </apex:composition>
7</apex:page>

Visualforce 開発者ガイド

<apex:composition> を使用したテンプレートの定義

動的テンプレート