Summary
Tag name:
<
af:tree
>
UIComponent class:
oracle.adf.view.faces.component.core.data.CoreTree
Component type:
oracle.adf.CoreTree
The ADF Tree is used to display data that is structured in a hierarchical format.
This component supports multiple root elements, and it has a
simple user interface (UI) - each element in the Tree is appropriately indented to indicate
its level in the hierarchy, and is connected to its parent.
The features of the Tree component include mechanisms for expanding and
collapsing portions of the hierarchy. This component is not well suited
for massive trees, since it does not support any focusing capability.
The "nodeStamp" facet of the Tree is used to display the
data for each element in the tree. The "nodeStamp" is repeatedly
rendered (stamped) once per element.
Example:
In the following
example, the data for each element is placed under the EL property
"node". The "nodeStamp" displays the data for each element by
getting further properties from the "node" property:
<af:tree var="node" value="#{myBean.orgChart.root}">
<f:facet name="nodeStamp">
<af:outputText value="#{node.firstname}"/>
</f:facet>
</af:tree>
Events
|
Type
|
Phases
|
Description
|
|
oracle.adf.view.faces.event.DisclosureEvent
|
Apply Request Values
Invoke Application
|
Event delivered when user expands or collapses a subtree.
|
Supported Facets
|
Name
|
Description
|
|
nodeStamp
|
the component to use to stamp each element in the
tree. Only certain types of components are supported,
including all
components with no behavior and most components that implement the
EditableValueHolder or ActionSource interfaces. In a treeTable, this must be a column.
|
Attributes
Ungrouped attributes
|
Name
|
Type
|
Supports EL?
|
Description
|
|
attributeChangeListener
|
javax.faces.el.MethodBinding
|
Only EL
|
a method reference to an attribute change listener
|
|
disclosureListener
|
javax.faces.el.MethodBinding
|
Only EL
|
a method reference to a disclosure listener
|
|
focusRowKey
|
Object
|
Yes
|
the rowKey of the currently focused row.
The rowKeys of the ancestor rows of the focus row are added
to the treeState pathSet by default.
|
|
immediate
|
boolean
|
Yes
|
whether or not data validation - client-side or
server-side -
should take place when
events are generated by this component.
When immediate is true, the default ActionListener
provided by the JavaServer Faces implementation
should be executed during Apply Request Values phase
of the request processing lifecycle, rather than
waiting until the Invoke Application phase.
|
|
partialTriggers
|
String[
]
|
Yes
|
the IDs of the components that should trigger a partial update.
This component will listen on the trigger components. If one of the
trigger components receives an event that will cause it to update
in some way, this component will reque
st to be updated too.
|
|
treeState
|
oracle.adf.view.faces.model.PathSet
|
Yes
|
the set of expanded nodes for this component.
Each entry in the set is a path of an expanded node.
|
|
value
|
Object
|
Yes
|
the hierarchy of tree data - must be of type
oracle.adf.view.faces.model.TreeModel
|
|
var
|
String
|
No
|
Name of the EL variable used to reference each element of this collection.
Once this component has completed rendering, this variable is
removed (or reverted back to its previous value).
|
|
varStatus
|
String
|
No
|
Name of the EL variable used to reference the varStatus information.
Once this component has completed rendering, this variable is
removed (or reverted back to its previous value).
The VarStatus provides contextual information about the state of the
component to EL expressions. For components that iterate, varStatus
also provides loop counter information. Please see the this
component's documentation for the specific properties on the varStatus.
The common properties on varStatus include:
-
"model" - returns the CollectionModel for this component
-
"index" - returns the zero based row index
|
Core attributes
|
Name
|
Type
|
Supports EL?
|
Description
|
|
binding
|
oracle.adf.view.faces.component.
core.data.CoreTree
|
Only EL
|
a binding reference to store the component instance
|
|
id
|
String
|
No
|
the identifier for the component. This must be a valid XML ID,
and therefore may not contain whitespace or start with a number. Also,
JSF requires that IDs must not contain
any colons (":").
|
|
inlineStyle
|
String
|
Yes
|
the inline CSS style for this element
|
|
rendered
|
boolean
|
Yes
|
whether the bean is rendered. When set to false,
no output will be delivered for this bean.
|
|
shortDesc
|
String
|
Yes
|
the short description of the bean. This text
is commonly used by user agents to display tooltip help text.
|
|
styleClass
|
String
|
Yes
|
the CSS style class of the bean.
|
Javascript attributes
|
Name
|
Type
|
Supports EL?
|
Description
|
|
onclick
|
String
|
Yes
|
an onclick Javascript handler.
|
|
ondblclick
|
String
|
Yes
|
an ondblclick Javascript handler.
|
|
onkeydown
|
String
|
Yes
|
an onkeydown Javascript handler.
|
|
onkeypress
|
String
|
Yes
|
an onkeypress Javascript handler.
|
|
onkeyup
|
String
|
Yes
|
an onkeyup Javascript handler.
|
|
onmousedown
|
String
|
Yes
|
an onmousedown Javascript handler.
|
|
onmousemove
|
String
|
Yes
|
an onmousemove Javascript handler.
|
|
onmouseout
|
String
|
Yes
|
an onmouseout Javascript handler.
|
|
onmouseover
|
String
|
Yes
|
an onmouseover Javascript handler.
|
|
onmouseup
|
String
|
Yes
|
an onmouseup Javascript handler.
|
Bookmark
