<tree>要素 |
![]() |
ネームスペース: | http://xmlns.oracle.com/uix/ui |
派生元: | <ui:base>要素 |
グループ: | UIX Components |
要素の型: | UINode |
構文 |
![]() |
<tree
[ formName="string" ]
[ formSubmitted="boolean" ]
[ unvalidated="boolean" ] [ data:nodes ="data binding to oracle.cabo.ui.data.DataObjectList" ] [ data:proxy ="data binding to oracle.cabo.ui.data.tree.TreeDataProxy" ] > <nodes></nodes> <nodeStamp></nodeStamp> <proxy></proxy> </tree>
説明 |
![]() |
<tree>要素は、オブジェクトを階層形式に表示するために使用されます。 開いている、または閉じている子ノード、リーフ・ノードおよび親ノードにデータを取り込みます。 ツリー・コントロールの用途は、ユーザーが複雑な階層構造のオブジェクト・セットに素早く目を通し、ツリー内でハイライト表示することで、レコードの詳細情報にアクセスできるようにすることです。 ツリーを使用して階層を視覚的に表示することで、オブジェクト間の相互の関係を示す目的もあります。
TreeBeanは、クライアントで静的にレンダリングされます。 ただし、データがすべて静的である必要はありません。 すべてのユーザー間で共有される静的データを、レンダリング時に決まるクライアントの状態と組み合せる方法が提供されます。 TreeBeanデータは、TreeBeanの属性として設定できるTreeDataProxyインタフェースを実装するオブジェクトを使用して、レンダリングごとに設定できます。 TreeDataProxyの便利な実装の1つが、ClientStateTreeProxyです。 これは、ノードが開いている/閉じている状態を管理し、オプションでクライアントおよびサーバーの両方のツリーでの選択を、レンダリングごとに管理します。 TreeBeanでは、ID、nodesおよびproxyの3つの属性と、1つの名前の付けられた子をサポートします。
ツリーのIDは、サーバーによるイベント時のツリーの識別に使用されます。
proxy属性はオプションで、各ノードの一部のプロパティを取得するメソッドを提供します。
nodes属性は、ツリーのルート・ノードを含むDataObjectListを返します。 この最初のDataObjectListは、すべてのルート、つまり最上位のノードを示します。 ルート・ノードの数は、このルートDataObjectListでのgetLength()をコールした結果により決まり、getItem(int index)へのコールにより返されるすべてのDataObjectがルートDataObjectの1つを返します。
ユーザーは、ツリーの名前の付けられた子nodeStampを指定できます。 nodeStampは、適切なノード・データを使用してツリーの各ノードでレンダリングされるUINodeです。 ノード・スタンプが指定されていない場合、デフォルトのスタンプであるアイコンおよびリンクが使用されます。 これらの各ルート・ノードDataObjectの子を決定するには、nodes属性の値を順に取得します。 この値は、ノードに子がないことを示すnullか、ノードの子を表す別のDataObjectListのいずれかです。 これらのDataObjectListも、nodes属性を使用して問い合され、ツリーをレンダリングするために、ツリー構造全体の作成が完成するまでプロセスが続きます。 各DataObjectはツリーで表示されるノードを表していることに注意してください。 特定のノードの実際の外観は、プロキシを介した一連の問合せにより取得されたプロパティにより決まります。 ノードのプロパティは、次のとおりです。
ツリー階層データ
ツリー・ノードの外観
例 |
![]() |
データ・バインドされたproxy属性を持つツリー
<ctrl:content xmlns:ui="http://xmlns.oracle.com/uix/ui">
<dataScope xmlns="http://xmlns.oracle.com/uix/ui">
<contents>
<tree name="tree1" proxy="${TreeProxy.proxy}">
<nodes>
<nodes text="Root1" expandable="collapsed"/>
<nodes text="Root2" expandable="collapsed"/>
<nodes text="Root3" expandable="expanded">
<nodes text="Node3-1"/>
<nodes text="Node3-2" expandable="expanded">
<nodes text="Node3-2-1" selected="false" />
<nodes text="Node3-2-2" selected="true" expandable="no"/>
<nodes text="Node3-2-3" expandable="no"/>
</nodes>
<nodes text="Node3-3" expandable="no"/>
</nodes>
<nodes text="Root4" expandable="collapsed"/>
</nodes>
</tree>
</contents>
<provider>
<data name="TreeProxy">
<method class="oracle.cabo.doc.demo.DataTrees"
method="getTreeProxy"/>
</data>
</provider>
</dataScope>
</ctrl:content>
<ctrl:handlers xmlns="http://xmlns.oracle.com/uix/controller">
<event name="expand">
<method class="oracle.cabo.doc.demo.DataTrees"
method="expandEventHandler"/>
</event>
</ctrl:handlers>
属性 |
![]() |
|
子要素 |
![]() |
|