Module org.omnifaces

Package org.omnifaces.component.tree

Class TreeNode

java.lang.Object

jakarta.faces.component.UIComponent

jakarta.faces.component.UIComponentBase

org.omnifaces.component.tree.TreeFamily

org.omnifaces.component.tree.TreeNode

All Implemented Interfaces:

PartialStateHolder, StateHolder, TransientStateHolder, ComponentSystemEventListener, FacesListener, SystemEventListenerHolder, EventListener

public class TreeNode
extends TreeFamily

The <o:treeNode> is an UIComponent that represents a single tree node within a parent Tree component. Within this component, the var attribute of the parent Tree component will expose the tree node. Each of its children is processed by TreeNodeItem.

The level attribute can be used to specify for which tree node level as obtained by TreeModel.getLevel() this component should render the children by TreeNodeItem. The root tree node has level 0.

Author:

Bauke Scholtz

See Also:

• Tree
• TreeNodeItem

Field Summary

Fields

Modifier and Type	Field	Description
static final String	COMPONENT_TYPE	The component type, which is "org.omnifaces.component.tree.TreeNode".

Fields inherited from class org.omnifaces.component.tree.TreeFamily

COMPONENT_FAMILY

Fields inherited from class jakarta.faces.component.UIComponent

ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, FACETS_KEY, VIEW_LOCATION_KEY

Constructor Summary

Constructors

Constructor	Description
TreeNode()

Method Summary

Modifier and Type	Method	Description
Integer	getLevel()	Returns the level for which this node should render the items.
protected void	process(FacesContext context, PhaseId phaseId)	This method is by design only called by Tree.processTreeNode(FacesContext, PhaseId) as it maintains all the nodes.
void	setLevel(Integer level)	Sets the level for which this node should render the items.
protected void	validateHierarchy(FacesContext context)	Validate the component hierarchy.

Methods inherited from class org.omnifaces.component.tree.TreeFamily

encodeChildren, getFamily, getRendersChildren, processDecodes, processSuper, processUpdates, processValidators

Methods inherited from class jakarta.faces.component.UIComponentBase

addClientBehavior, addFacesListener, broadcast, clearInitialState, decode, encodeAll, encodeBegin, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getDefaultEventName, getEventNames, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getParent, getPassThroughAttributes, getRenderer, getRendererType, invokeOnComponent, isRendered, isTransient, markInitialState, processRestoreState, processSaveState, queueEvent, removeFacesListener, restoreAttachedState, restoreState, saveAttachedState, saveState, setId, setParent, setRendered, setRendererType, setTransient, visitTree

Methods inherited from class jakarta.faces.component.UIComponent

getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getListenersForEventClass, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, setValueExpression, subscribeToEvent, unsubscribeFromEvent

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

COMPONENT_TYPE

public static final String COMPONENT_TYPE

The component type, which is "org.omnifaces.component.tree.TreeNode".

See Also:

• Constant Field Values

Constructor Details

TreeNode

public TreeNode()

Method Details

validateHierarchy

protected void validateHierarchy(FacesContext context)

Validate the component hierarchy.

Specified by:

validateHierarchy in class TreeFamily

Parameters:

context - The faces context to work with.

Throws:

IllegalStateException - When the direct parent component isn't of type Tree, or when this component is nested in another TreeNode, or when there aren't any children of type TreeNodeItem.

process

protected void process(FacesContext context,
 PhaseId phaseId)

This method is by design only called by Tree.processTreeNode(FacesContext, PhaseId) as it maintains all the nodes.

Specified by:

process in class TreeFamily

Parameters:

context - The faces context to work with.

phaseId - The current phase ID.

See Also:

• Tree.processTreeNode(FacesContext, PhaseId)

getLevel

public Integer getLevel()

Returns the level for which this node should render the items.

Returns:

The level for which this node should render the items.

setLevel

public void setLevel(Integer level)

Sets the level for which this node should render the items.

Parameters:

level - The level for which this node should render the items.