詳細アイコン JSF宣言コンポーネントのメタデータの作成

例に従うには、この手順およびキュー・カード全体で、指示に表示されている値を入力します。これによって、記述されているとおりにキュー・カードの手順に従うことができるようになります。

宣言コンポーネントは再利用可能なコンポジット・コンポーネントで、他の既存のADF Facesコンポーネントで構成されています。宣言コンポーネントは、異なるコンテンツまたは同じコンテンツを使用して、1つのページまたは複数のページの個別部分を作成する際のベースとして使用できます。たとえば、1つのページの個別部分または複数のページ間に共通の一連のボタンがある場合は、それらのボタンを構成する宣言コンポーネントを作成し、共通機能が必要なページで使用できます。

宣言コンポーネントは、そのコンポーネントが定義されているプロジェクトと同じプロジェクトでは使用できません。つまり、あるプロジェクトで宣言コンポーネントを作成し、別のプロジェクトでは、その宣言コンポーネントを使用するページを作成する必要があります。

宣言コンポーネントの作成を開始するには、「JSF宣言コンポーネントの作成」ダイアログを開きます。このダイアログを開くには、アプリケーション・ナビゲータで宣言コンポーネント・プロジェクト・ノードを右クリックし、「新規」を選択します。次に新規ギャラリで、「Web層」カテゴリを開いて「JSF」を選択し、「アイテム」リストで「JSF宣言コンポーネント」を選択します。

新規ギャラリ、JSF宣言コンポーネントのアイテム

宣言コンポーネントは、XMLで記述されたファイル拡張子が.jspxのコンポーネント定義ファイルに作成されます。宣言コンポーネントは、コンポーネント定義ファイル内のメタデータ・セクションとレイアウト・セクションの2つのセクションに記述されます。メタデータ・セクションには、コンポーネントのすべてのメタデータ(コンポーネントの表示名やタグ・ライブラリ情報など)が含まれ、レイアウト・セクションには、コンポジット宣言コンポーネントを構成する個別のADF Facesコンポーネントすべてが含まれます。

「JSF宣言コンポーネントの作成」ダイアログでは、宣言コンポーネントのメタデータ(宣言コンポーネントの表示名、コンポーネントに組み込むことができるファセット定義、属性メソッド)のみを作成できます。

「JSF宣言コンポーネントの作成」ダイアログ

作成する宣言コンポーネントには、メニュー・バー・コンポーネントとメニュー・コンポーネントが含まれます。この例では、宣言コンポーネントの名前を入力し、ファセット定義、属性およびメソッドを追加します。属性を使用すると、ページ作成者は、メニュー・アイテム・コンポーネントのラベルを設定できます。メソッドを使用すると、ページ作成者は、アクション・リスナー・メソッドをメニュー・アイテム・コンポーネントに設定できます。ファセットを使用すると、ページ作成者は、必要に応じて、メニュー・コンポーネントを追加できます。

「JSF宣言コンポーネントの作成」ダイアログでは、宣言コンポーネントの新規JSPタグ・ライブラリの詳細も指定します。つまり、タグ・ライブラリには、宣言コンポーネントと、ページ上のライブラリおよび宣言コンポーネントへのアクセス方法が含まれます。新規JSPタグの詳細を追加するには、「タグ・ライブラリの追加」をクリックして、「宣言コンポーネント・タグ・ライブラリの作成」ダイアログを使用します。

「宣言コンポーネント・タグ・ライブラリの作成」ダイアログ