|
Oracle UIX API Reference Release 2.1.22.0.0 B12196-01 |
||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Object
|
+--oracle.cabo.ui.DeprecatedUINode
|
+--oracle.cabo.ui.BaseUINode
|
+--oracle.cabo.ui.BaseMutableUINode
|
+--oracle.cabo.ui.beans.BaseWebBean
|
+--oracle.cabo.ui.beans.MarlinBean
|
+--oracle.cabo.ui.beans.nav.BrowseMenuBean
This bean is not supported on the following agent types: pda.
The BrowseMenu is used in applications where information is in a hierarchical tree-like structure of categories (internal nodes) and items (leaves). The user can drill down through categories to find the item he/she is looking for. The BrowseMenu can contain any number of categories, subcategories and subsubcategories. The purpose of the BrowseMenu is to allow users to browse through complex sets of hierarchical objects, looking at one node at a time.
The BrowseMenuBean supports the following attributes:
The BrowseMenuBean supports four named children:
The BrowseMenuBean is essentially a layout manager which places these named children at the appropriate locations. The BLAF guidlines show a BreadCrumbsBean as the location element, a LinkBean as the content link element, a BulletedListBean to display categories and another BulletedListBean to display items.
The BrowseMenu is meant to help navigate hierarchical data, but the hierarchical data isn't added to the BrowseMenu itself. Instead, we provide the class BrowseNodeDataObject which can extract the appropriate information from data that is stored hierarchically. Furthermore, users who wish to use the BLAF guideline BrowseMenu can use BrowseMenuUtils.configureBrowseMenu to easily add the appropriate attributes and children to a BrowseMenu. Furthermore, BrowseNodeDataObject can be used to wire up the data. Please see BrowseMenuUtils and BrowseNodeDataObject for further information.
The BrowseMenuBean itself, however, expects the named children to contain all the appropriate data. As mentioned above the bean is really a layout manager. If you are not using BrowseMenuUtils you will need to construct beans with the appropriate data and add them as named children.
The expected behavior of BrowseMenu is that when you click on a category the BrowseMenu takes you to a view of the data at that level. This functionality is not provided by the BrowseMenuBean. BrowseMenuUtils in combination with BrowseNodeDataObject provides one default implementation of this functionality which can be used either in part or in full.
An example setup of the data and handler for an interactive browse menu. Replace the comment with one of the browse menu's below.
<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>An example of a browse menu.
<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>An example of a browse menu which uses BrowseMenuUtils to configure the browse menu
<browseMenu id="myBrowseMenu"
formSubmitted="true"
defaultContents="true"
source="data:browseData"/>
BrowseMenuUtils,
BrowseNodeDataObject,
UIConstants| Constructor Summary | |
|
BrowseMenuBean()
Construct an instance of the BrowseMenuBean. |
protected |
BrowseMenuBean(boolean ignored,
java.lang.String localName)
Construct an instance of the BrowseMenuBean. |
|
BrowseMenuBean(UINode locationNode,
UINode contentLinkNode,
UINode itemsNode,
UINode categoriesNode)
Construct an instance of the BrowseMenuBean. |
| Method Summary | |
UINode |
getCategories()
Bean to use to render categories. |
static UINode |
getCategories(MutableUINode bean)
Bean to use to render categories. |
java.lang.String |
getCategoryTitle()
Gets the title of the category section. |
static java.lang.String |
getCategoryTitle(MutableUINode bean)
Gets the title of the category section. |
UINode |
getContentLink()
Bean to use to link to category content. |
static UINode |
getContentLink(MutableUINode bean)
Bean to use to link to category content. |
java.lang.String |
getFormName()
Gets form to which browseMenu events should be submitted |
static java.lang.String |
getFormName(MutableUINode bean)
Gets form to which browseMenu events should be submitted |
UINode |
getItems()
Bean to use to render items. |
static UINode |
getItems(MutableUINode bean)
Bean to use to render items. |
java.lang.String |
getItemTitle()
Gets the title of the items section. |
static java.lang.String |
getItemTitle(MutableUINode bean)
Gets the title of the items section. |
UINode |
getLocation()
Bean to use to render locator element at top. |
static UINode |
getLocation(MutableUINode bean)
Bean to use to render locator element at top. |
java.lang.String |
getLongDesc()
Gets the description seen just under the title to describe the current location. |
static java.lang.String |
getLongDesc(MutableUINode bean)
Gets the description seen just under the title to describe the current location. |
java.lang.String |
getTitle()
Gets the title of the browse menu. |
static java.lang.String |
getTitle(MutableUINode bean)
Gets the title of the browse menu. |
boolean |
isFormSubmitted()
Gets Sets whether or not to use form submission |
static boolean |
isFormSubmitted(MutableUINode bean)
Gets Sets whether or not to use form submission |
boolean |
isUnvalidated()
Gets If this element is used in formSubmitted
mode, then the default behaviour is to validate all form inputs,
before submitting to the server. |
static boolean |
isUnvalidated(MutableUINode bean)
Gets If this element is used in formSubmitted
mode, then the default behaviour is to validate all form inputs,
before submitting to the server. |
static void |
setCategories(MutableUINode bean,
UINode categoriesNode)
Bean to use to render categories. |
void |
setCategories(UINode categoriesNode)
Bean to use to render categories. |
static void |
setCategoryTitle(MutableUINode bean,
java.lang.String categoryTitle)
Sets the title of the category section. |
void |
setCategoryTitle(java.lang.String categoryTitle)
Sets the title of the category section. |
static void |
setContentLink(MutableUINode bean,
UINode contentLinkNode)
Bean to use to link to category content. |
void |
setContentLink(UINode contentLinkNode)
Bean to use to link to category content. |
static void |
setFormName(MutableUINode bean,
java.lang.String formName)
Sets form to which browseMenu events should be submitted |
void |
setFormName(java.lang.String formName)
Sets form to which browseMenu events should be submitted |
void |
setFormSubmitted(boolean formSubmitted)
Sets Sets whether or not to use form submission |
static void |
setFormSubmitted(MutableUINode bean,
boolean formSubmitted)
Sets Sets whether or not to use form submission |
static void |
setItems(MutableUINode bean,
UINode itemsNode)
Bean to use to render items. |
void |
setItems(UINode itemsNode)
Bean to use to render items. |
static void |
setItemTitle(MutableUINode bean,
java.lang.String itemTitle)
Sets the title of the items section. |
void |
setItemTitle(java.lang.String itemTitle)
Sets the title of the items section. |
static void |
setLocation(MutableUINode bean,
UINode locationNode)
Bean to use to render locator element at top. |
void |
setLocation(UINode locationNode)
Bean to use to render locator element at top. |
static void |
setLongDesc(MutableUINode bean,
java.lang.String longDesc)
Sets the description seen just under the title to describe the current location. |
void |
setLongDesc(java.lang.String longDesc)
Sets the description seen just under the title to describe the current location. |
static void |
setTitle(MutableUINode bean,
java.lang.String title)
Sets the title of the browse menu. |
void |
setTitle(java.lang.String title)
Sets the title of the browse menu. |
static void |
setTranslatableCategoryTitle(MutableUINode bean,
java.lang.String bundleName,
java.lang.String key)
Binds to a ResourceBundle the the title of the category section. |
void |
setTranslatableCategoryTitle(java.lang.String bundleName,
java.lang.String key)
Binds to a ResourceBundle the the title of the category section. |
static void |
setTranslatableItemTitle(MutableUINode bean,
java.lang.String bundleName,
java.lang.String key)
Binds to a ResourceBundle the the title of the items section. |
void |
setTranslatableItemTitle(java.lang.String bundleName,
java.lang.String key)
Binds to a ResourceBundle the the title of the items section. |
static void |
setTranslatableTitle(MutableUINode bean,
java.lang.String bundleName,
java.lang.String key)
Binds to a ResourceBundle the the title of the browse menu. |
void |
setTranslatableTitle(java.lang.String bundleName,
java.lang.String key)
Binds to a ResourceBundle the the title of the browse menu. |
void |
setUnvalidated(boolean unvalidated)
Sets If this element is used in formSubmitted
mode, then the default behaviour is to validate all form inputs,
before submitting to the server. |
static void |
setUnvalidated(MutableUINode bean,
boolean unvalidated)
Sets If this element is used in formSubmitted
mode, then the default behaviour is to validate all form inputs,
before submitting to the server. |
| Methods inherited from class oracle.cabo.ui.beans.MarlinBean |
isEqualMarlinName |
| Methods inherited from class oracle.cabo.ui.BaseUINode |
getAttributeNames, getAttributeValue, getAttributeValueImpl, getChildArray, getChildNames, getIndexedChild, getIndexedChild, getIndexedChildCount, getLocalName, getNamedChild, getNamespaceURI, getNodeID, getNodeRole, getPreorderDescendentAttributeValue, getRawAttributeValue, getRenderedUINode, getRenderer, getRenderer, render, render, toString |
| Methods inherited from class oracle.cabo.ui.DeprecatedUINode |
getAttributeValue, getChildNames, getNamedChild |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| Methods inherited from interface oracle.cabo.ui.UINode |
getAttributeNames, getAttributeValue, getAttributeValue, getChildNames, getChildNames, getIndexedChild, getIndexedChild, getIndexedChildCount, getLocalName, getNamedChild, getNamedChild, getNamespaceURI, getNodeID, getNodeRole, getRawAttributeValue, render, render |
| Constructor Detail |
public BrowseMenuBean()
public BrowseMenuBean(UINode locationNode,
UINode contentLinkNode,
UINode itemsNode,
UINode categoriesNode)
locationNode - Bean to use to render locator element at top.contentLinkNode - Bean to use to link to category content.itemsNode - Bean to use to render items.categoriesNode - Bean to use to render categories.
protected BrowseMenuBean(boolean ignored,
java.lang.String localName)
| Method Detail |
public final UINode getContentLink()
public final void setContentLink(UINode contentLinkNode)
public final UINode getItems()
public final void setItems(UINode itemsNode)
public final UINode getCategories()
public final void setCategories(UINode categoriesNode)
public final UINode getLocation()
public final void setLocation(UINode locationNode)
public final java.lang.String getTitle()
public final void setTitle(java.lang.String title)
public final void setTranslatableTitle(java.lang.String bundleName,
java.lang.String key)
bundleName - the name of the ResourceBundlekey - the key of the string to retrieve from the ResourceBundlepublic final java.lang.String getCategoryTitle()
public final void setCategoryTitle(java.lang.String categoryTitle)
public final void setTranslatableCategoryTitle(java.lang.String bundleName,
java.lang.String key)
bundleName - the name of the ResourceBundlekey - the key of the string to retrieve from the ResourceBundlepublic final java.lang.String getItemTitle()
public final void setItemTitle(java.lang.String itemTitle)
public final void setTranslatableItemTitle(java.lang.String bundleName,
java.lang.String key)
bundleName - the name of the ResourceBundlekey - the key of the string to retrieve from the ResourceBundlepublic final java.lang.String getLongDesc()
public final void setLongDesc(java.lang.String longDesc)
public final boolean isFormSubmitted()
public final void setFormSubmitted(boolean formSubmitted)
public final boolean isUnvalidated()
formSubmitted
mode, then the default behaviour is to validate all form inputs,
before submitting to the server. This attribute allows
this validation to be disabled.public final void setUnvalidated(boolean unvalidated)
formSubmitted
mode, then the default behaviour is to validate all form inputs,
before submitting to the server. This attribute allows
this validation to be disabled.public final java.lang.String getFormName()
public final void setFormName(java.lang.String formName)
public static UINode getContentLink(MutableUINode bean)
public static void setContentLink(MutableUINode bean,
UINode contentLinkNode)
public static UINode getItems(MutableUINode bean)
public static void setItems(MutableUINode bean,
UINode itemsNode)
public static UINode getCategories(MutableUINode bean)
public static void setCategories(MutableUINode bean,
UINode categoriesNode)
public static UINode getLocation(MutableUINode bean)
public static void setLocation(MutableUINode bean,
UINode locationNode)
public static java.lang.String getTitle(MutableUINode bean)
public static void setTitle(MutableUINode bean,
java.lang.String title)
public static void setTranslatableTitle(MutableUINode bean,
java.lang.String bundleName,
java.lang.String key)
bundleName - the name of the ResourceBundlekey - the key of the string to retrieve from the ResourceBundlepublic static java.lang.String getCategoryTitle(MutableUINode bean)
public static void setCategoryTitle(MutableUINode bean,
java.lang.String categoryTitle)
public static void setTranslatableCategoryTitle(MutableUINode bean,
java.lang.String bundleName,
java.lang.String key)
bundleName - the name of the ResourceBundlekey - the key of the string to retrieve from the ResourceBundlepublic static java.lang.String getItemTitle(MutableUINode bean)
public static void setItemTitle(MutableUINode bean,
java.lang.String itemTitle)
public static void setTranslatableItemTitle(MutableUINode bean,
java.lang.String bundleName,
java.lang.String key)
bundleName - the name of the ResourceBundlekey - the key of the string to retrieve from the ResourceBundlepublic static java.lang.String getLongDesc(MutableUINode bean)
public static void setLongDesc(MutableUINode bean,
java.lang.String longDesc)
public static boolean isFormSubmitted(MutableUINode bean)
public static void setFormSubmitted(MutableUINode bean,
boolean formSubmitted)
public static boolean isUnvalidated(MutableUINode bean)
formSubmitted
mode, then the default behaviour is to validate all form inputs,
before submitting to the server. This attribute allows
this validation to be disabled.
public static void setUnvalidated(MutableUINode bean,
boolean unvalidated)
formSubmitted
mode, then the default behaviour is to validate all form inputs,
before submitting to the server. This attribute allows
this validation to be disabled.public static java.lang.String getFormName(MutableUINode bean)
public static void setFormName(MutableUINode bean,
java.lang.String formName)
|
Oracle UIX API Reference Release 2.1.22.0.0 B12196-01 |
||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||