How to Configure the Controls on a Node

29-16 Web User Interface Developers Guide for Oracle Application Development Framework Figure 29–9 Hierarchy Viewer Component with Same-Level Navigation

29.5 Adding Interactivity to a Hierarchy Viewer Component

You can configure a hierarchy viewer component to invoke popup windows and display menus with functionality and data from other pages in your Oracle Fusion web application.

29.5.1 How to Configure 3D Tilt Panning

By default, panning in a hierarchy viewer is accomplished by clicking and dragging the component to reposition the view, or by using the panning control in the Control Panel. In a hierarchy viewer with a large quantity of nodes, instead of browsing through a hierarchy viewer one page at a time, users can initiate a 3D tilt panning effect that animates the hierarchy viewer to visually fly through the hierarchy viewer nodes. Once set in motion toward the edge of a view, the effect continues automatically until it reaches the end of the nodes on an edge. Figure 29–10 shows the tilt panning effect as it reaches the edge of the view. Figure 29–10 Hierarchy Viewer 3D Tilt Panning Effect Using ADF Hierarchy Viewer Components 29-17 To use the tilt panning effect you should first adjust the zoom level on the hierarchy view for an acceptable view of the content of the nodes. You can initiate the effect in any of these ways: ■ Click and drag using the pan control in the control panel to initiate tilt panning after a short period of regular panning. ■ Click and drag the view one-third of the way across the viewport. ■ Click and hold the cursor near the edge of the view to initiate tilt panning in that direction. Once the tilt panning effect is initiated, you can move the cursor within the view to change the direction of the pan through the view. Exit tilt panning by selecting any node in the view. You configure 3D tilt panning effect for the hierarchy viewer by setting the panning property to tilt.

29.5.2 How to Configure Node Selection Action

By default, clicking a hierarchy viewer node at runtime selects the node. You can customize this interaction by setting the clickBehavior attribute on the dvt:node component. Valid values for this property include: ■ focus - The node receives focus and is selected when clicked default. ■ expandCollapse - Child node elements are either expanded or collapsed, depending on their current expansion state. ■ isolateRestore - The node is either isolated or restored, depending on its current state. ■ none - Clicking the node does nothing.

29.5.3 How to Configure a Hierarchy Viewer to Invoke a Popup Window

You can invoke a popup window from a hierarchy viewer node by specifying values for the af:showPopupBehavior tag and invoking it from a command component, for example, af:commandButton. You must nest the command component that invokes the popup inside an f:facet element in a node of the hierarchy viewer component. The triggerType property of an af:showPopupBehavior tag used in this scenario supports only the following values: ■ action ■ mouseHover For example, Figure 29–11 shows a modal popup invoked from an HR Detail link in the node. Example 29–2 shows sample code for creating the popup. Example 29–3 shows sample code for the invoking the popup from a command component. For brevity, elements such as af:panelGroupLayout, af:spacer, and af:separator are not included in the sample code.