JBoss.orgCommunity Documentation

6.88.  < rich:changeExpandListener >

The <rich:changeExpandListener> represents an action listener method that is notified on an expand/collapse event on the node.

Table 6.482. rich : changeExpandListener attributes

Attribute NameDescription
bindingThe attribute takes a value-binding expression for a component property of a backing bean

Table 6.483. Component identification parameters

NameValue
listener-classorg.richfaces.event.NodeExpandedListener
event-classorg.richfaces.event.NodeExpandedEvent
tag-classorg.richfaces.taglib.ChangeExpandListenerTag

To create the simplest variant on a page use the following syntax:

Example:


...
    <rich:changeExpandListener type="demo.Bean"/>
...

Example:

package demo;

public class ImplBean implements org.richfaces.event.NodeExpandedListener{
    ...
}
import demo.ImplBean;

...
ImplBean myListener = new ImplBean();
...

The <rich:changeExpandListener> is used as a nested tag with <rich:tree> and <rich:treeNode> components.

Attribute "type" defines the fully qualified Java class name for the listener. This class should implement org.richfaces.event.NodeExpandedListener interface.

The typical variant of using:


...
<rich:tree switchType="server" value="#{project.data}" var="item" nodeFace="#{item.type}">
    <rich:changeExpandListener type="demo.ListenerBean"/>
    ...
    <!-- Tree nodes --> 
    ...
</rich:tree>
...

Java bean source:

package demo;

import org.richfaces.event.NodeExpandedEvent;
public class ListenerBean implements org.richfaces.event.NodeExpandedListener{
... 
    public void processExpansion(NodeExpandedEvent arg0){
        //Custom Developer Code 
    }
...
}
...

<rich:changeExpandListener> has no skin parameters and custom style classes, as the component isn't visual.