Figure 4: Visual editor, Structure window, and Property Inspector view of the sample application’s
Index.jsf page
red rectangles in Figure 3). Local navigation
(content added to the green area in Figure 3)
launches or switches among task flows
exposed on tabs in the template’s local area
(the yellow rectangle in Figure 3).
To define global navigation, you add
the Oracle ADF Faces af:navigationPane
component to the global Toolbar facet and
add af:commandNavigationItem components as child components to handle
the navigation. Alternatively, you can use
an XML menu model that you can create
from page navigation defined in the
adfc-config.xml file to dynamically render the
af:commandNavigationItem instances.
The sample application has af:tree and
af: table components added to the navigation
facet representing the navigation area (green
in Figure 3). The navigation facet enables
users to navigate content exposed in the
local area. The local area of the template is
managed by the Dynamic Tabs UI Shell API
to conditionally display, hide, and navigate
content exposed in bounded task flows.
Each new task flow dynamically opens in a
tab panel. An inner toolbar can be used to
manage opened tabs—to, for example, close
all tabs or all but the selected tab, as implemented in the sample application.
The footer area consists of three facets
you can use for adding copyright, status, and
descriptive information.
box, create a new JSF page, using the Page
entry of the Web Tier -> JSF/Facelets option.
In the Create JSF Page dialog box, select the
ADF Page Template option, choose Oracle
Dynamic Tabs Shell, and then click OK.
The new page opens in the visual page
editor, showing the template facets and
default labels. You can use the Oracle
JDeveloper Structure window, shown in
Figure 4, to add components to the template
facets easily by dragging them there. To edit
the template logo and default labels and
messages, select the af:page Template node
in the Structure window and open the Oracle
Property Inspector (Ctrl + Shift + I).
When you use the Dynamic Tabs UI Shell
template, Oracle JDeveloper automatically
updates the project libraries’ dependencies
with a reference to the Oracle page template
library. To see this, open the ViewController
project properties by double-clicking the
Projects node. In the Project Properties dialog
box, select the Libraries and Classpath node
and scroll through the list of configured
libraries to locate the Oracle Page Templates
entry. Select Oracle Page Templates, and click
the View button to see the reference to the
oracle-page-templates.jar file, which is an
Oracle ADF library. This library contains—
along with the page template itself—the
Java classes and task flow configuration
that provide the dynamic functionality. Click
Cancel to close the dialog box.
ADDING THE DYNAMIC TABS UI SHELL
TEMPLATE TO A PAGE
To create a new JSF page based on the
Dynamic Tabs UI Shell template, open and
select a ViewController project and then
choose File -> New. In the New Gallery dialog
DYNAMIC TABS UI SHELL TEMPLATE
ARCHITEC TURE
By taking a deeper look at the Dynamic Tabs
UI Shell template architecture, you’ll better
understand how the template works and
how it should be used and also learn some
good Oracle ADF programming practices.
