<af:panelGroupLayout>

af:panelGroupLayout panelGroupLayout panel group layout

UIComponentクラス: oracle.adf.view.rich.component.rich.layout.RichPanelGroupLayout
コンポーネントのタイプ: oracle.adf.RichPanelGroupLayout

panelGroupLayoutコントロールはレイアウトの要素で、単純なパターンの1つを使用してその子を配置するものです。隣り合う子のペアは、オプションの子セパレータで区切られます。これは連続して(必要に応じて折返し)、または一本の水平線上に、または垂直方向に、子をレイアウトします。<p/>レイアウトのストレッチ、およびレイアウトのフロー/スクロールに関する注意: <p/>今日のWebブラウザでは、スクロール・バーを持つ領域でコンテンツを垂直方向にストレッチする方法は確実ではありません。ページの構成外の領域をストレッチするときは、コンポーネント・ツリーのアセンブル方法に注意が必要です。

経験則:

  1. ユーザーはネストされたスクロールバーを好まないため、スクロール用panelGroupLayoutを別のスクロール用panelGroupLayout内に配置しないでください。
  2. コンポーネントのinlineStyle属性にパーセンテージ高さを指定しないでください。
  3. コンポーネントのinlineStyle属性にpositionスタイルを使用しないでください。
  4. 固定のピクセル高さを使用している場合を除き、レイアウト属性に設定した値とは関係なく、panelSplitterまたはpanelStretchLayoutをpanelGroupLayout内に配置しません。

これらのいずれかの規則に違反すると、ページ構造がページ構造ガイドラインに従わないものとなり、各種Webブラウザおよびコンピューティング・プラットフォーム間で一貫性のあるアプリケーションのレンダリングを行うことができなくなる可能性があります。

<p/>またpanelGroupLayoutには、facetRef、iteratorまたはswitcherを配置することもでき、それらの解決された子はpanelGroupLayoutの直接の子として扱われます。このように動作させないようにする場合は、グループ化する子をgroupコンポーネントでラップします。<section name="Geometry_Management">

</section>

イベント

フェーズ 説明
org.apache.myfaces.trinidad.event.AttributeChangeEvent アプリケーションの起動、
リクエスト値の適用
属性変更を記述するために配信されるイベント。属性変更イベントは、プロパティに対するプログラム的な変更については配信されません。アプリケーションの特定のリクエストなしにレンダラによってプロパティが変更される場合にのみ配信されます。属性変更イベントの例には、クライアント側のサイズ変更をサポートしていた列の幅などがあります。

サポートされるファセット

名前 説明
separator その他の子の間で、1度レンダリングされるコンテンツ。

属性

名前 ELのサポート 説明
attributeChangeListener javax.el.MethodExpression ELのみ 属性変更リスナーへのメソッド・リファレンス。属性変更イベントは、プロパティに対するプログラム的な変更については配信されません。アプリケーションの特定のリクエストなしにレンダラによってプロパティが変更される場合にのみ配信されます。属性変更イベントの例には、クライアント側のサイズ変更をサポートしていた列の幅などがあります。
binding oracle.adf.view.rich.component.<wbr/>rich.layout.RichPanelGroupLayout ELのみ コンポーネント・インスタンスをBean上に格納するELリファレンス。これは、バッキングBeanからコンポーネントへのプログラム的なアクセスを提供するため、またはコンポーネントの作成をバッキングBeanに移動するために使用できます。
clientComponent boolean あり クライアント側のコンポーネントが生成されるかどうか。このフラグを設定してもしなくてもコンポーネントは生成されますが、クライアントJavascriptがコンポーネント・オブジェクトを必要とする場合、コンポーネントの存在を保証するにはtrueに設定する必要があります。現在デフォルトで生成されるクライアント・コンポーネント・オブジェクトは、将来は存在しない可能性があります。このフラグを設定することがコンポーネントの存在を保証する唯一の方法であり、クライアントは暗黙的な動作に依存できません。ただし、このフラグの設定にはパフォーマンス・コストが伴うため、絶対に必要でないかぎり、クライアントではクライアント・コンポーネントを有効にすることを避ける必要があります。
customizationId String あり この属性は推奨されていません。永続的なカスタマイズを適用するには、id属性を使用する必要があります。この属性は、次のリリースでは削除されます。
halign String あり 有効な値: start、center、end、left、right

水平、垂直、スクロールのレイアウトの水平位置合せ。これはlayoutがdefaultのとき、無視されます。layoutがhorizontalの場合、ブラウザで水平位置合せを確実に処理できるのは、固定幅が設定されたコンポーネントか、またはoutputTextなどのインラインのコンポーネントにかぎられることに注意してください。
id String なし コンポーネントの識別子。識別子は、HTMLで許可される構文のサブセットに準拠している必要があります。
  • 長さゼロの文字列は指定しないでください。
  • 最初の文字は、ASCII文字(A-Za-z)またはアンダースコア(_)にする必要があります。
  • 後続の文字は、ASCII文字または数字(A-Za-z0-9)、アンダースコア(_)またはダッシュ(-)にする必要があります。
inlineStyle String あり このコンポーネントに対して使用するCSSスタイル。これは、基本スタイルの変更用です。inlineStyleは、コンポーネントのルートDOM要素に適用されるCSSスタイルのセットです。inlineStyleのCSSプロパティが対象となるDOM要素に影響を与えない場合は、スキンを作成し、特定のDOM要素をターゲットにしたスキニング・キーを使用する必要があります(::label、::icon-styleなど)。
layout String あり 有効な値: default、horizontal、vertical、scroll

レイアウトのタイプ。許容される値には次のものが含まれます。
  • default: 折返し可能で、双方向レイアウト・アルゴリズムに従ってブラウザにより定義された連続的なレイアウト。結果として、右から左へ進むテキストと左から右へ進むテキストが混在し、コンテンツが連続して表示されない場合があります。
  • horizontal: 折返しなしで厳密に連続している状態。
  • vertical: 垂直にスタックされた状態。
  • scroll: コンテンツがオーバーフローした場合、スクロール・バーとともに垂直に表示されます(このレイアウト・オプションは、decorativeBoxでstretchChildrenを持つpanelSplitter、panelStretchLayoutまたはshowDetailItemがfirstに設定されているときなど、panelGroupLayoutがストレッチされている場合にのみ使用します)。
partialTriggers String[] あり 部分更新をトリガーするコンポーネントのID。このコンポーネントは、トリガー・コンポーネント上でリスニングします。トリガー・コンポーネントの1つがなんらかの更新を発生させるイベントを受信した場合、このコンポーネントも更新されることをリクエストします。識別子はソース・コンポーネント(このコンポーネント)に対して相対的であり、NamingContainerで構成されている必要があります。コンポーネントがすでにネーミング・コンテナ内にある場合、単一のコロンを使用するとページのルートから検索を開始でき、複数のコロンを使用するとNamingContainerを上方向に移動できます。たとえば、::を前に置くと、コンポーネントのネーミング・コンテナ(または、コンポーネントがネーミング・コンテナである場合にはそのコンポーネント自体)から出てそこから検索を開始します。:::を前に置くと、2つのネーミング・コンテナ(コンポーネントがネーミング・コンテナである場合にはそのコンポーネント自体も含まれます)から出てそこから検索を開始します。
rendered boolean あり コンポーネントがレンダリングされるかどうか。falseに設定した場合、このコンポーネントについて出力は配信されません(コンポーネントはどのような方法でもレンダリングされず、クライアントで表示できません)。
shortDesc String あり コンポーネントの短い説明。このテキストは、通常、ツールチップ・ヘルプ・テキストを表示するためにユーザー・エージェントによって使用されます。この場合、ツールチップの動作はユーザー・エージェントによって制御されます。たとえば、Firefox 2では長いツールチップは切り捨てられます。フォーム・コンポーネントの場合、shortDescはノート・ウィンドウに表示されます。
styleClass String あり このコンポーネントに対して使用するCSSスタイル・クラス。スタイル・クラスは、jspxページまたはスキニングCSSファイルなどで定義できます。または、AFInstructionTextのようなパブリック・スタイル・クラスの1つを使用できます。
theme String あり このコンポーネントの子に適用するコンポーネント・スタイル・テーマ。デフォルトでは、このコンポーネントは異なるテーマ用にスタイル指定されませんが、af:documentおよびaf:decorativeBoxで発生するスキン変更が関連付けられていないテーマの変更に使用できます。テーマと色調スタイルには互換性がないため、ページ当たりで使用できるメソッド(テーマまたは色調スタイル)は1つのみです。テーマが空白の場合には現在のテーマが削除され、テーマの値がinheritまたはNull、あるいはテーマを設定していない場合には、現在のテーマが使用されます。スキンはテーマのソースです。スキンの中には、定義にテーマが設定されていないものもあります。テーマ名には、dark、medium、lightおよびdefaultを使用することをお薦めします。
valign String あり 有効な値: middle、top、bottom、baseline

水平方向のレイアウトの垂直位置合せ。これはlayoutがhorizontalでない場合、無視されます。
visible boolean あり コンポーネントの可視性。falseの場合、コンポーネントはクライアント上で非表示となります。renderedとは異なり、これはサーバーでのライフサイクルには影響を与えません(コンポーネントに実行済バインディングがある、など)。コンポーネントの可視性は、クライアント上で切り替えるか、PPRを使用して切り替えることができます。renderedがfalseの場合、コンポーネントはどのような方法でもレンダリングされず、クライアントで表示できません。ほとんどの場合、visibleプロパティのかわりにrenderedプロパティを使用します。
次のレンダーキットではサポートされていません。 org.apache.myfaces.trinidad.core