Project Documentation

Summary

Tag name: <t:tree>
UIComponent class: org.apache.myfaces.custom.tree.HtmlTree
Tag class: org.apache.myfaces.custom.tree.taglib.TreeTag
Component type: org.apache.myfaces.HtmlTree
Component family: org.apache.myfaces.HtmlTree
Renderer type: org.apache.myfaces.HtmlTree
Renderer class: org.apache.myfaces.custom.tree.renderkit.html.HtmlTreeRenderer

A tree data component. Unless otherwise specified, all attributes accept static values or EL expressions.

Tree implementation based on javax.swing.JTree.

The tree model is assigned by using a value binding named model and is not stored in view state.

A hierarchy of {@link HtmlTreeNode}objects is used to represent the current expanded state of the tree. The root node is held as a faces named * rootNode.

Screen Shot

tree

Usage

value="TreeModel"
           styleClass="CSSClass"
           nodeClass="CSSClass"
           selectedNodeClass="CSSClass"
           expandRoot="{true|false}">
</t:tree>

Instructions

see examples/tree.jsp for an example!

Attributes

Name Type Supports EL? Description
binding String Only EL Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.
columnClasses String Yes
expandRoot boolean No
expireListeners long Yes Time interval the tree will remain registered as a TreeModelListener without being accessed
footerClass String Yes
headerClass String Yes
iconChildFirst String Yes
iconChildLast String Yes
iconChildMiddle String Yes
iconClass String Yes
iconLine String Yes
iconNodeClose String Yes
iconNodeCloseFirst String Yes
iconNodeCloseLast String Yes
iconNodeCloseMiddle String Yes
iconNodeOpen String Yes
iconNodeOpenFirst String Yes
iconNodeOpenLast String Yes
iconNodeOpenMiddle String Yes
iconNoline String Yes
id String Yes An identifier for this particular component instance within a component view.

The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view

This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted.

value org.apache.myfaces.custom.tree.model.TreeModel Yes
nodeClass String Yes
rendered boolean Yes A boolean value that indicates whether this component should be rendered. Default value: true.
rowClasses String Yes
selectedNodeClass String Yes
styleClass String Yes The CSS class for this element. Corresponds to the HTML 'class' attribute.
var String Yes