showDetail、showDetailHeaderおよびshowDetailItemコンポーネントについて

コンポーネントのグループを表示(開示)または非表示(非開示)に切り替えるには、showDetailおよびshowDetailHeaderコンポーネントを使用します。showDetailHeaderでは、次の図のように、切り替えるコンテンツがヘッダーの下にあり、panelHeaderに類似しています。

showdetailHeaderとshowDetail(テキストの説明を参照)

showDetailshowDetailHeaderはいずれも、デフォルトの矢印アイコンとコンテンツの表示/非表示をユーザーに示すプロンプトをレンダリングします。ユーザーが矢印アイコンまたはプロンプトをクリックすると、それに応じてコンテンツが表示または非表示になります。

コンテンツが非表示の場合は、矢印アイコンにプラス記号(+)が表示され、アイコンはプロンプトまたはヘッダー・テキストの方向を指します。コンテンツが表示されている場合は、矢印アイコンにマイナス記号(-)が表示され、アイコンは下方向を指します。デフォルトのプロンプトまたはヘッダー・テキストは、次のとおりです。

showDetailItemコンポーネントは、子コンポーネントの開示(表示)に使用する点でshowDetailおよびshowDetailHeaderに似ています。通常、showDetailItemコンポーネントは、ユーザーが子コンポーネントの1グループを1回で選択および表示できるように、ShowOneコンポーネント(showOneTabshowOneChoiceなど)内で使用します。

次の図は、showOneTab内で使用される5つのshowDetailItemコンポーネントを示しています。図の後で、showOneTab内でのshowDetailItemの動作を説明しますが、これはすべてのShowOneコンポーネントにも該当する内容です。

ShowOneTabとその5つのshowDetailItemコンポーネント

タブ・リンクのテキストは、showDetailItemtext属性で指定されます。ユーザーがタブをクリックまたは選択すると、そのタブのshowDetailItem子コンポーネントが開示(表示)されます。showDetailshowDetailHeaderとは異なり、showDetailItemコンテンツは非開示または非表示にしません。別のタブを選択すると、そのタブの子コンポーネントが開示(表示)され、以前に選択したタブの子コンポーネントは自動的に非開示(非表示)になります。アクティブなタブ(つまり、showDetailItem子コンポーネントを表示できるタブ)は、タブ・リンクがクリック可能(有効)な状態になります。無効なタブはグレー表示になり、タブをクリックしてコンテンツを表示できないことを示します。showDetailItemdisabled属性は、タブ・リンクの表示状態(有効または無効)を指定します。デフォルトでは、この属性はfalse(つまり、タブは有効)です。

showDetailshowDetailHeaderまたはshowDetailItemdisclosed属性は、コンテンツの状態(表示または非表示)を指定します。デフォルトでは、この属性はfalse(つまり、コンテンツは非表示)です。ユーザーが矢印アイコンをクリックしてコンテンツを表示または非表示にしたり、タブをクリックしてそのコンテンツを表示すると、DisclosureEventが配信されます。DisclosureEventに関連するリスナーはDisclosureListenerです。コンポーネントのDisclosureListener属性は、イベントを処理するバッキングBeanのDisclosureListenerメソッドにバインドできます。このメソッドは、DisclosureEventに応じて(つまり、ユーザーがコンテンツを表示または非表示にする都度)起動されます。

ADF FacesのshowDetailshowDetailHeaderおよびshowDetailItemコンポーネントは、そのアクションに部分ページ・レンダリングを使用します。部分ページ・レンダリングがクライアント・ブラウザまたはプラットフォームでサポートされない場合は、かわりに全ページ・レンダリングが自動的に使用されます。

ヒント: showDetailHeaderコンポーネントによって作成されるセクション・ヘッダーは、ページ上で有効になるとADF Facesクイック・リンクに挿入されます。クイック・リンクの長さを短くするには、showDetailHeadershortText属性を設定し、text属性をさらに簡潔にわかりやすくした説明を用意します。


ADF Facesでの部分ページ・レンダリングのサポートについて