Oracle Fusion Middleware Data Visualization Tools Tag Reference for Oracle ADF Faces
12c (12.2.1.2)

E76719-01

<dvt:node>

dvt:node node node

UIComponent class: oracle.adf.view.faces.bi.component.hierarchyViewer.Node
Component type: oracle.dss.adf.hierarchyViewer.Node

The node component is used to stamp out nodes in the hierarchy.

The "zoom100", "zoom75", "zoom50", and "zoom25" facets are used to specify the stamps for different zoom levels of the hierarchy. The "zoom100" facet is typically the most detailed, showing the most information, because the nodes are larger at 100% size. The "zoom25" facet is typically the least detailed, showing the least information, because the nodes are smaller at 25% size. All zoom facets only support a single child component.

The following tags are allowed as children of the zoom facets:

Usage of the following tags has been deprecated.

Relationship with other tags

This component must be a child of the <dvt:hierarchyViewer> component.

The node component can have the following children: facet.

Example

The following example shows XML for a node tag.
<dvt:hierarchyViewer>
<dvt:node width="233" height="233">
<f:facet name="zoom100">
<af:panelGroupLayout layout="vertical" inlineStyle="width:100%;height:100%;padding:5px">
<af:panelGroupLayout layout="horizontal">
<af:panelGroupLayout inlineStyle="width:85px;height:120px">
<af:image source="#{node.Thumburl}"/>
</af:panelGroupLayout>
<af:spacer width="5" height="5"/>
<af:panelGroupLayout layout="vertical">
<af:outputText value="#{node.Firstname}" inlineStyle="font-weight:bold;font-size:20px;color:#383A47"/>
<af:outputText value="#{node.Lastname}" inlineStyle="font-size:20px;color:#383A47"/>
<af:outputText value="#{node.Title}" inlineStyle="font-size:11px;font-style:italic;color:#383A47"/>
</af:panelGroupLayout>
</af:panelGroupLayout>
</af:panelGroupLayout>
</f:facet>
</dvt:node>
</dvt:hierarchyViewer>

Gradient background and border

By default, the node displays a gradient background that transitions from its background-color to white. The gradient can be turned off so that the background is a solid color by specifying the custom attribute "fill-type:solid" in the inlineStyle attribute on the <dvt:node> tag.

Similarly, by default, the node displays a gradient border based on its border-color. The gradient can be turned off so that the border is a solid color by specifying the custom attribute "border-type:solid" in the inlineStyle attribute on the <dvt:node> tag.

Popups

Popups launched from components in hierarchy viewer nodes can be configured to show contextual information about the node. The application can use <af:setPropertyListener> in the <af:popup> to get information from the data row associated with the node when the popup launches and transfer it to a managed bean. The components in the popup can then refer to that information stored in the managed bean when the popup renders.

Note that the desired information must be retrieved when the popup launches and stored away because the node context is only temporarily set during the popup launch. The node context on hierarchy viewer may change by the time the popup renders, but the information stored in the managed bean will not be affected.

In the above example, note that:

In this example, the setPropertyListener uses the special hierarchy viewer property "currentRowData" to transfer the entire data row for the node to a managed bean. The popup contents can then refer to any item in the data row, such as "Empno", "Ename", and "Job". Alternatively, multiple setPropertyListeners could be used to retrieve and store each data item separately.

Instead of getting the data for the row, the application can get the row key to use to lookup data outside of the hierarchy viewer model. In that case, the from attribute of the setPropertyListener should be set to "#{source.rowKey}".

Hover window

By default, when a node is zoomed out to 75% or below and the mouse hovers over the node, a built-in hover window is displayed showing the node at 100%. This behavior can be overridden by specifying an <af:showPopupBehavior> tag with triggerType="mouseHover" in the node stamp, most likely as a child of the outermost container element, to show a custom ADF Faces popup instead.

The following example shows XML for such a case.

       <dvt:node width="233" height="233" id="n0">
         ...
         <f:facet name="zoom75">
           <af:panelGroupLayout inlineStyle="width:100%;height:100%;padding:3px;"
                                layout="vertical" id="pgl1">
             <af:showPopupBehavior popupid="O__popup1" triggerType="mouseHover"
                                   alignid="pgl1" align="beforeEnd"/>
             ...
           </af:panelGroupLayout>
         </f:facet>
         ...
       </dvt:node>
       

Events

Type Phases Description
org.apache.myfaces.trinidad.event.AttributeChangeEvent Invoke Application,
Apply Request Values
Event delivered to describe an attribute change. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change event might include the width of a column that supported client-side resizing.

Supported Facets

Name Description
zoom100 The template used to stamp out nodes at 100% zoom. This will typically be the most detailed template.
zoom25 The template used to stamp out nodes at 25% zoom. This will typically be the least detailed template.
zoom50 The template used to stamp out nodes at 50% zoom. This will typically be less detailed than the zoom75 template.
zoom75 The template used to stamp out nodes at 75% zoom. This will typically be less detailed than the zoom100 template.

Attributes

Name Type Supports EL? Description
attributeChangeListener javax.el.MethodExpression Only EL a method reference to an attribute change listener. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change events might include the width of a column that supported client-side resizing.
binding oracle.adf.view.faces.bi.component.hierarchyViewer.Node Only EL an EL reference that will store the component instance on a bean. This can be used to give programmatic access to a component from a backing bean, or to move creation of the component to a backing bean.
clickBehavior String Yes Valid Values: focus, expandCollapse, isolateRestore, none
Default Value: focus

Specifies the override build-in action. The default value is focus. Valid values are:

  • "focus" - set focus on the node
  • "expandCollapse" - toggle between expand and collapse
  • "isolateRestore" - toggle between isolate and restore
  • "none" - no action
draggable String Yes Valid Values: on, off, yes, no
Default Value: on

Specifies if a node is draggable. Valid values are "on" (default) and "off". The values "yes" and "no" are deprecated.
facetName String Yes For internal use only
height int Yes Specifies the height of the node, in pixels, at full size
id String No the identifier for the component
inlineStyle String Yes The inline style of the hierarchy viewer node. Can be used to control the colors/fonts of the hierarchy viewer node.
rendered boolean Yes Default Value: true

Specifies whether the component is rendered. This is used in conjunction with the type attribute to determine which node template to stamp out for a given data element. The first node component whose type matches that of the data element will be stamped for that data element. If no type matches, then the first node whose rendered attributes evaluates to true will be stamped for that data element.
setAnchorListener javax.el.MethodExpression Only EL a method reference to a set anchor action listener, the method is invoked when the end user marks a node as the new anchor of the HierarchyViewer, normally via a double-click mouse action
shape String Yes Valid Values: rect, roundedRect, ellipse
Default Value: roundedRect

Specifies the shape of the node. Valid values are:

  • "rect" - rectangular
  • "roundedRect" - rectangular with rounded corners
  • "ellipse" - elliptical
shortDesc String Yes Sets a short description of this node for user agents rendering to non-visual media (e.g. screen readers)
showExpandChildren boolean Yes Default Value: true

Specifies whether the Expand Children action is rendered
showIsolate boolean Yes Default Value: true

Specifies whether the Isolate action is rendered
showNavigateUp boolean Yes Default Value: true

Specifies whether the Navigate Up action is rendered.
styleClass String Yes Sets a CSS style class to use for this component
type String Yes Specifies the types of nodes this stamp should be used for. This is used in conjunction with the rendered attribute to determine which node template to stamp out for a given data element. The first node component whose type matches that of the data element will be stamped for that data element. If no type matches, then the first node whose rendered attributes evaluates to true will be stamped for that data element.
width int Yes Specifies the width of the node, in pixels, at full size