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

カスタムコンポーネントの定義

Visualforce ページで使用するカスタムコンポーネントを定義する手順は、次のとおりです。

Salesforce の [設定] から、[クイック検索] ボックスに「コンポーネント」と入力し、[Visualforce コンポーネント] を選択します。
[新規] をクリックします。
[表示ラベル] テキストボックスに、設定ツールでカスタムコンポーネントの識別に使用するテキストを入力します。
[オブジェクト名] テキストボックスに、Visualforce マークアップ内でカスタムコンポーネントを識別するテキストを入力します。この名前は、アンダースコアと英数字のみを含み、組織内で一意の名前にする必要があります。最初は文字であること、スペースは使用しない、最後にアンダースコアを使用しない、2 つ続けてアンダースコアを使用しないという制約があります。
[説明] テキストボックスに、カスタムコンポーネント説明を入力します。この説明は、[保存] をクリックするとすぐに、他の標準コンポーネントの説明と共にコンポーネントの参照に表示されます。
[内容] テキストボックスに、カスタムコンポーネント定義用の Visualforce マークアップを入力します。1 つのコンポーネントに、最大 1 MB のテキスト、約 1,000,000 文字を入れることができます。
[Version Settings (バージョン設定)] をクリックして、Visualforce のバージョンとこのコンポーネントで使用する API を指定します。また、組織にインストールされている管理パッケージのバージョンを指定できます。
[保存] をクリックし、変更を保存してカスタムコンポーネントの詳細画面を参照するか、[適用] をクリックし、変更を保存してコンポーネントの編集を続行します。コンポーネントを保存するには、Visualforce マークアップが有効になっている必要があります。

カスタムコンポーネントは、Visualforce の開発モードで、Visualforce ページマークアップにまだ存在しないカスタムコンポーネントへの参照を追加することによって作成することもできます。マークアップを保存すると、コンポーネントに指定した名前に基づいて (指定の属性を含む) 新規のコンポーネント定義を作成するためのクイック修正リンクが表示されます。

たとえば、myNewComponent というカスタムコンポーネントがまだ定義されていない場合に、既存のページマークアップに <c:myNewComponent myNewAttribute="foo"/> を挿入して [保存] をクリックすると、クイック修正によって myNewComponent という名前の新規カスタムコンポーネントを定義できます。このコンポーネントのデフォルト定義は次のとおりです。

1<apex:component>
2  <apex:attribute name="myattribute" type="String" description="TODO: Describe me"/>
3  <!-- Begin Default Content REMOVE THIS -->
4  <h1>Congratulations</h1>
5  This is your new Component: mynewcomponent
6  <!-- End Default Content REMOVE THIS -->
7</apex:component>

この定義は、[設定] から、[クイック検索] ボックスに「コンポーネント」と入力して [Visualforce コンポーネント] を選択し、myNewComponent カスタムコンポーネントの横にある [編集] をクリックして編集できます。

メモ

コンポーネントが作成されたら、http://mySalesforceInstance/apexcomponent/nameOfNewComponent でこれを参照できます。mySalesforceInstance の値は Salesforce インスタンスのホスト名 (na3.salesforce.com など)、nameOfNewComponent は、カスタムコンポーネント定義の [名前] 項目の値です。

コンポーネントは、一見 Visualforce ページのように表示されます。そのため、コンポーネントが属性またはコンポーネントタグ本体のコンテンツに依存している場合は、この URL から予測と違う結果が生じる場合があります。より正確にカスタムコンポーネントをテストするには、コンポーネントを Visualforce ページに追加してからページを表示してください。

Visualforce 開発者ガイド

カスタムコンポーネントの定義