<hGrid>要素
ネームスペース: http://xmlns.oracle.com/uix/ui
派生元: <ui:base>要素
グループ: UIX Components
要素の型: UINode

このタグは、ツリー構造のデータを表要素に似た形式で表示するために使用します。 TreeBeanとは異なり、HGridBeanはサブツリーのフォーカス・インおよびフォーカス・アウトをサポートしているため、大規模なツリーでの使用に適しています。
このBeanは、エージェントのタイプがPDA、携帯電話、音声の場合にはサポートされません。

構文
<hGrid
    [ alternateText="string" ]
    [ childBlockSize="nonNegativeInteger" ]
    [ destination="anyURI" ]
    [ formSubmitted="boolean" ]
    [ nameTransformed="boolean" ]
    [ partialRenderMode="ui:partialRenderModeTypeHGrid" ]
    [ partialTargets="NMTOKENS" ]
    [ proxied="boolean" ]
    [ summary="string" ]
    [ unvalidated="boolean" ]
    [ width="string" ]
    [ data:tableFormat ="data binding to oracle.cabo.ui.data.DataObject" ]
    [ data:columnFormats ="data binding to oracle.cabo.ui.data.DataObjectList" ]
    [ data:columnHeaderData ="data binding to oracle.cabo.ui.data.DataObjectList" ]
    [ data:columnHeaderFormats ="data binding to oracle.cabo.ui.data.DataObjectList" ]
    [ data:proxy ="data binding to oracle.cabo.ui.data.tree.HGridDataProxy" ]
    [ data:treeData ="data binding to oracle.cabo.ui.data.DataObject" ]
>
     <!-- The following child can be anything derived from the given element -->
   <tableFormat></tableFormat>
   <columnFormats></columnFormats>
   <columnHeaderData></columnHeaderData>
   <columnHeaderFormats></columnHeaderFormats>
   <columnHeaderStamp></columnHeaderStamp>
   <contents><!-- indexed children --></contents>
   <nodeStamp></nodeStamp>
   <proxy></proxy>
   <tableActions></tableActions>
   <tableSelection></tableSelection>
   <treeData></treeData>
</hGrid>

注意:
  • この要素は派生元要素のすべての属性と子要素を持つことができます。
  • data:で始まる属性は、実際には要素となります。 data:は、その属性構文がデータ・バインディングせずに使用されることがないことを示しています。

  • 説明

    <hGrid>要素は、オブジェクトをTreeBeanに似た階層形式で表示するために使用されます。 HGridはTableBeanのようにレンダリングされ、各行がツリーの1つのノードに対応します。 HGridには、フォーカス列およびオブジェクト階層列の2つの特殊な列があります。 オブジェクト階層列は、現行のツリー・ノードを識別し、ユーザーがこのノードを開く(子を表示)または閉じる(子を隠す)ことができるようにします。 フォーカス列は、ツリーの新しいルートを選択するために使用されます。 この列により、ユーザーは大規模なツリーのサブツリーにズーム・インできます。 HGridはナビゲータをレンダリングして、ユーザーが現行のサブツリーからフォーカス・アウト(ズーム・アウト)できるようにします。 HGridはリンクをレンダリングして、ユーザーが現行のフォーカス・ルート下のすべてのノードを簡単に開いたり、または閉じたりできるようにもします。

    HGrid階層データ
    階層データは、TreeBeanの場合と同じように提供されます。 ただし、HGridのルートは、DataObjectListではなく、DataObjectです。 このルートは、treeData属性のバインディングにより指定します。 また、HGridではTreeBeanと同じキーを使用して各DataObject(ツリー・ノードを表す)に問合せを実行します。

    オブジェクト階層列のコンテンツをレンダリングするには、TreeBeanと同様、nodeStampを使用できます。 このオブジェクト階層列の列ヘッダーのデフォルトはNameです。 ただし、nodeStampとしてColumnBeanを設定し、そのColumnBeancolumnHeaderを設定することにより変更できます。

    HGridを機能させるには、プロキシ・オブジェクトをバインドする必要があります。 プロキシの説明は、TreeBeanを参照してください。 HGridでは、プロキシはoracle.cabo.ui.data.tree.HGridDataProxy型で、proxy属性を使用してバインドされます。 このようなプロキシの例は、oracle.cabo.ui.data.tree.ClientStateHGridDataProxyを参照してください。
    HGridの外観
    HGridの外観は、TableBeanと同様の方法で制御します。 列ヘッダーはcolumnHeaderData属性およびcolumnHeaderStampを使用して宣言します。 列の値は、HGridの索引付きの子(コンテンツ)として設定します。 様々な書式オプションを、tableFormatcolumnFormatsおよびcolumnHeaderFormatsの各属性を使用して設定できます。 これらの属性の詳細な説明は、TableBeanのドキュメントを参照してください。 また、TableBeanでは行の書式オプションがサポートされているのに対し、HGridではそれらがサポートされないことに注意してください。


    <hGrid id="hg1">
     <treeData text="Root" expandable="expanded">
      <nodes text="Child 1"/>
      <nodes text="Child 2"/>
     </treeData>
    </hGrid>

    属性

    説明
    alternateText 空のHGrid内で表示するテキスト。
    string
    childBlockSize ノード下に一度に表示できる子ノードの最大レコード数。 ノードがchildBlockSizeで指定した数を超える子を持つ場合、子ノードの上下にナビゲーション行がレンダリングされます。
    nonNegativeInteger
    destination hGridによって生成されるすべてのリンクのベース・リンク先。
    URI
    formSubmitted hGridのプロキシにより生成されるリンクでフォーム送信を使用するかどうか。
    boolean
    nameTransformed データ・コントロールのレンダリング時に、TableBeanで名前の変換をするかどうかを指定するブール値。デフォルトでは、名前は変換されます。2.1.11以降推奨されていません。かわりに、ColumnBeanのnameTransformed属性を使用してください。
    boolean
    partialRenderMode

    partialRenderMode属性は、hGridコンポーネントのページの部分レンダリング動作を制御するために使用します。partialRenderModeのデフォルトはnoneで、hGridのすべての処理でページの全体レンダリングが使用されます。 partialRenderModeがselfまたはmultipleに設定されている場合、開く、閉じる、およびフォーカスを当てるためのイベントがページの部分イベントとして送信されるため、ページ全体を再度レンダリングせずに指定された部分ターゲットを更新できます。

    ページの部分レンダリングを有効にするには、hGridコンポーネントのid属性が設定されていること、hGridがUIXの<body>要素とともに使用されていることが必要です。 これらの要件が満たされ、partialRenderModeがselfまたはmultipleに設定されている場合に、hGridコンポーネントでは、アプリケーションへのイベント送信時にページの部分レンダリング・アーキテクチャが使用されます。 これらの要件のいずれかが満たされていない場合、あるいはブラウザでページの部分レンダリングをサポートしていない場合には、ページの全体レンダリングが実行されます。


    ui:partialRenderModeTypeHGrid
    partialTargets partialRenderModeがmultipleに設定されている場合の部分ターゲット・ノードのID。 hGridのIDは、一連の部分ターゲットに自動的に含まれ、partialTargetsのリストには明示的に指定されません。
    NMTOKENS
    proxied クライアントでのレンダリング時に、HGridにJava Scriptのプロキシ・コードを含めるかどうか。
    boolean
    summary ビジュアルでないメディアにレンダリングするユーザー・エージェント用の、表の用途および構造の要約。 この属性を指定しない場合は、text属性の値が使用されます。
    string
    unvalidated このhGridのプロキシにより生成されるフォーム送信の前に検証を行うかどうか。 デフォルトでは、検証は実行されません。 この属性は、hGridをformSubmittedモードで使用している場合にのみ使用可能です。
    boolean
    width HGridの幅。
    string

    子要素

    説明 必須 組込み可能な数
    <tableFormat>
    表全体の書式情報。
    いいえ 1
    <columnFormats>
    各列の書式情報。
    いいえ 1
    <columnHeaderData>
    列ヘッダーのデータ。
    いいえ 1
    <columnHeaderFormats>
    各列の書式情報。
    いいえ 1
    <columnHeaderStamp>
    各列ヘッダーのレンダリングに使用されるノード。
    いいえ 1
    <contents>
    Beanの索引付けされた子。
    いいえ 1
    <nodeStamp>
    各ツリー・ノードにレンダリングするUINode。 これは、オブジェクト階層の列ヘッダーの設定にも使用できます。
    いいえ 1
    <proxy>
    ツリー・ノードと、それらのノードの開閉状態、選択状態、フォーカス状態および子の間にあるプロキシ。
    いいえ 1
    <tableActions>
    行選択に依存しないhgridでのアクションの実行に使用されるコンポーネント。
    いいえ 1
    <tableSelection>
    表での選択を有効にします。
    いいえ 1
    <treeData>
    HGridのデータ。
    いいえ 1