<browseMenu>要素 |
![]() |
ネームスペース: | http://xmlns.oracle.com/uix/ui |
派生元: | <ui:base>要素 |
グループ: | UIX Components |
要素の型: | UINode |
構文 |
![]() |
<browseMenu
[ categoryTitle="string"
]
[ defaultContents="boolean"
]
[ formName="string"
]
[ formSubmitted="boolean"
]
[ itemTitle="string"
]
[ longDesc="string"
]
[ source="QName"
]
[ title="string"
]
[ unvalidated="boolean"
] >
<categories> </categories>
<contentLink> </contentLink>
<items> </items>
<location> </location>
</browseMenu>
説明 |
![]() |
<browseMenu>要素は、カテゴリ(内部ノード)および項目(リーフ)の階層ツリー構造で情報が保持されるアプリケーションで使用します。ユーザーはカテゴリをドリルダウンして、目的の項目を見つけることができます。BrowseMenuには任意の数のカテゴリ、サブカテゴリおよびサブ・サブカテゴリを含めることができます。BrowseMenuを使用する目的は、ユーザーがノードを1つずつ見ながら、複雑な階層構造のオブジェクトを参照できるようにすることです。 BrowseMenuBeanは次の属性をサポートします。
BrowseMenuBeanは4つの名前の付けられた子をサポートします。
BrowseMenuBeanは、実際にこれらの名前の付けられた子を適切な場所に配置するレイアウト・マネージャです。BLAFガイドラインでは、BreadCrumbsBeanは位置の要素、LinkBeanはコンテンツ・リンクの要素、BulletedListBeanはカテゴリを表示するもの、別のBulletedListBeanは項目を表示するものとされています。 BrowseMenuは、階層構造のデータ間の移動を補助する方法ですが、階層構造のデータはBrowseMenu自体には追加されません。かわりに、階層構造で格納されているデータから適切な情報を抽出できるBrowseNodeDataObjectクラスが提供されています。また、BLAFガイドラインのBrowseMenuを使用すると、BrowseMenuUtils.configureBrowseMenuを使用して、BrowseMenuに適切な属性および子を簡単に追加できます。さらに、BrowseNodeDataObjectを使用してデータを結び付けることができます。詳細は、BrowseMenuUtilsおよびBrowseNodeDataObjectを参照してください。 ただし、BrowseMenuBeanでは、名前の付けられた子に適切なデータがすべて含まれているものとします。前述のように、Beanは実際にはレイアウト・マネージャです。BrowseMenuUtilsを使用しない場合は、適切なデータを持つBeanを作成し、それらを名前の付けられた子として追加する必要があります。 BrowseMenuの正しい動作は、カテゴリをクリックすると、BrowseMenuによりそのレベルのデータが表示されることです。この機能は、BrowseMenuBeanでは提供されません。BrowseMenuUtilsをBrowseNodeDataObjectと組み合せて使用すると、この機能のデフォルト実装の1つが提供され、その一部または全部を使用できます。
BrowseMenuの属性および子
BrowseMenuの使用方法
例 |
![]() |
対話型のBrowseMenuのデータおよびハンドラの設定例です。コメントは、その下のBrowseMenuのいずれかに置き換えてください。
<ctrl:content>
<dataScope xmlns="http://xmlns.oracle.com/uix/ui">
<provider>
<data name="data:browseData">
<method class="oracle.cabo.servlet.demo.BrowseMenuData"
method="getBrowseNodeDataObject"/>
</data>
<data name="data:Nodes">
<inline>
<nodes text="Shop"
destination="http://www.oracle.com"
expandable="expanded"
selected="true">
<nodes text="Books"
destination="http://www.oracle.com"
expandable="expanded">
<nodes text="Sale"
destination="http://www.oracle.com"
expandable="expanded"
selected="true">
<nodes text="Millennium"
destination="http://www.oracle.com" />
</nodes>
<nodes text="Fiction"
destination="http://www.oracle.com"/>
<nodes text="Non-Fiction"
destination="http://www.oracle.com"/>
</nodes>
<nodes text="Hardware"
expandable="expanded" >
<nodes text="Desktops"
destination="http://www.oracle.com"/>
<nodes text="Notebooks"
destination="http://www.oracle.com"/>
</nodes>
</nodes>
</inline>
</data>
</provider>
<contents>
<form name="myForm">
<contents>
<!-- REPLACE THIS COMMENT WITH
ONE OF THE EXAMPLES BELOW -->
</contents>
</form>
</contents>
</dataScope>
</ctrl:content>
<ctrl:handlers xmlns="http://xmlns.oracle.com/uix/controller">
<event name="browse">
<method class="oracle.cabo.servlet.demo.BrowseMenuData"
method="browseEventHandler"/>
</event>
</ctrl:handlers>
BrowseMenuの例です。
<browseMenu id="myBrowseMenu"
data:title="text@data:browseData"
data:longDesc="description@data:browseData"
formSubmitted="true"
formName="myForm">
<location>
<breadCrumbs data:rendered="renderLocation@data:browseData">
<contents data:childData="locationData@data:browseData">
<link data:text="text" data:destination="destination"/>
</contents>
</breadCrumbs>
</location>
<contentLink>
<link data:text="destinationText@data:browseData"
data:destination="destination@data:browseData"
data:rendered="renderContentLink@data:browseData"/>
</contentLink>
<categories>
<bulletedList data:rendered="renderCategories@data:browseData">
<contents data:childData="categoriesData@data:browseData">
<link data:text="text" data:destination="destination"/>
</contents>
</bulletedList>
</categories>
<items>
<bulletedList data:rendered="renderItems@data:browseData">
<contents data:childData="itemsData@data:browseData">
<link data:text="text" data:destination="destination"/>
</contents>
</bulletedList>
</items>
</browseMenu>
次は、BrowseMenuの構成にBrowseMenuUtilsを使用する例です。
<browseMenu id="myBrowseMenu"
formSubmitted="true"
defaultContents="true"
source="data:browseData"/>
属性 |
![]() |
子要素 |
![]() |
|