Send your remarks, comments or wishes to doc team
Subject:
Message:
Your name:
Your email:

JBoss.org Community Documentation

- Prev
- Next

## 6.97. < rich:treeNodesAdaptor >

### 6.97.1. Description

The <rich:treeNodesAdaptor> provides the possibility to define data models and create representations for them.

Figure 6.311. Expanded tree with <rich:treeNodesAdaptor>

### 6.97.2. Key Features

- Allows to define combined data models

- Possibility to define nodes for processing via attributes

Table 6.559. rich : treeNodesAdaptor attributes

Attribute Name | Description
--- | ---
binding | The attribute takes a value-binding expression for a component property of a backing bean
id | Every component may have a unique id that is automatically created if omitted
includedNode | This boolean expression is used to define which elements are processed. Default value is "true".
nodes | Defines collection to use at the other (non-top) levels of iteration
rendered | If "false", this component is not rendered
var | A request-scope attribute via which the data object for the current collection element will be used when iterating

Table 6.560. Component identification parameters

Name | Value
--- | ---
component-type | org.richfaces.TreeNodesAdaptor
component-class | org.richfaces.component.html.HtmlTreeNodesAdaptor
component-family | org.richfaces.TreeNodesAdaptor
tag-class | org.richfaces.taglib.TreeNodesAdaptorTag

### 6.97.3. Creating the Component with a Page Tag

Example:

    ...

    <rich:treeNodesAdaptor var="issue" nodes="#{model.issues}">

        <rich:treeNode>

            <h:commandLink action="#{project.click}" value="Project: #{project.name}" />

        </rich:treeNode>

        ...

        <!-- Others nodes -->

        ...

    </rich:treeNodesAdaptor>

    ...

### 6.97.4. Creating the Component Dynamically Using Java

Example:

    import org.richfaces.component.html.HtmlTreeNodesAdaptor;

    ...

    HtmlTreeNodesAdaptor myTreeNodesAdaptor = new HtmlTreeNodesAdaptor();

    ...

### 6.97.5. Details of Usage

The <rich:treeNodesAdaptor> component has a "nodes" attribute that defines a collection of elements to iterate through.

Collections are allowed to include lists, arrays, maps, XML NodeList and NamedNodeMap either as a single object.

The "var" attribute is used to access to the current collection element.

The <rich:treeNodesAdaptor> component can be nested without any limitations. See the following example.

Example:

    ...

    <rich:tree adviseNodeOpened="#{treeModelBean.adviseNodeOpened}" switchType="client">

        <rich:treeNodesAdaptor id="project" nodes="#{loaderBean.projects}" var="project">

            <rich:treeNode>

                <h:commandLink action="#{project.click}" value="Project: #{project.name}" />

            </rich:treeNode>

        <rich:treeNodesAdaptor id="srcDir" var="srcDir" nodes="#{project.srcDirs}">

            <rich:treeNode>

                <h:commandLink action="#{srcDir.click}" value="Source directory: #{srcDir.name}" />

            </rich:treeNode>

        <rich:treeNodesAdaptor id="pkg" var="pkg" nodes="#{srcDir.packages}">

            <rich:treeNode>

                <h:commandLink action="#{pkg.click}" value="Package: #{pkg.name}" />

            </rich:treeNode>

        <rich:treeNodesAdaptor id="class" var="class" nodes="#{pkg.classes}">

            <rich:treeNode>

                <h:commandLink action="#{class.click}" value="Class: #{class.name}" />

            </rich:treeNode>

        </rich:treeNodesAdaptor>

        </rich:treeNodesAdaptor>

        </rich:treeNodesAdaptor>

        </rich:treeNodesAdaptor>

    </rich:tree>

    ...

### 6.97.6. Relevant Resources Links

Here you can see the example of <rich:treeNodesAdaptor > usage and sources for the given example.

- Prev6.96. < rich:recursiveTreeNodesAdaptor ...
- Top of page
- Front page
- NextChapter 7. IDE Support