Apache Struts 2 Documentation > Home > Guides > Tag Developers Guide > Struts Tags > Tag Reference > UI Tag Reference > tree |

Apache Struts 2 Documentation
tree
Edit Page Browse Space Add Page Add News
Added by Rene Gielen, last edited by Don Brown on Jan 06, 2007 (view change)

## Description

Renders a tree widget with AJAX support.

The id attribute is normally specified, such that it could be looked up using javascript if necessary.

## Parameters

#### Name | #### Required | #### Default | #### Evaluated | #### Type | #### Description
--- | --- | --- | --- | --- | ---
accesskey | false |  | true | String | Set the html accesskey attribute on rendered html element
blankIconSrc | false |  | true | String | Blank icon image source.
childCollectionProperty | false |  | true | String | The childCollectionProperty property.
cssClass | false |  | true | String | The css class to use for element
cssStyle | false |  | true | String | The css style definitions for element ro use
disabled | false |  | true | String | Set the html disabled attribute on rendered html element
expandIconSrcMinus | false |  | true | String | Expand icon image source.
expandIconSrcPlus | false |  | true | String | Expand Icon image source.
gridIconSrcC | false |  | true | String | Image source for under child item child icons.
gridIconSrcL | false |  | true | String | Image source for last child grid.
gridIconSrcP | false |  | true | String | Image source for under parent item child icons.
gridIconSrcV | false |  | true | String | Image source for vertical line.
gridIconSrcX | false |  | true | String | Image source for grid for sole root item.
gridIconSrcY | false |  | true | String | Image source for grid for last root item.
iconHeight | false | 18px | true | String | Icon height
iconWidth | false | 19px | true | String | Icon width
id | false |  | true | String | id for referencing element. For UI and form tags it will be used as HTML id attribute
key | false |  | true | String | Set the key (name, value, label) for this particular component
label | false |  | true | String | Label expression used for rendering a element specific label
labelposition | false |  | true | String | Define label position of form element (top/left)
name | false |  | true | String | The name to set for element
nodeIdProperty | false |  | true | String | The nodeIdProperty property.
nodeTitleProperty | false |  | true | String | The nodeTitleProperty property.
onblur | false |  | true | String | Set the html onblur attribute on rendered html element
onchange | false |  | true | String | Set the html onchange attribute on rendered html element
onclick | false |  | true | String | Set the html onclick attribute on rendered html element
ondblclick | false |  | true | String | Set the html ondblclick attribute on rendered html element
onfocus | false |  | true | String | Set the html onfocus attribute on rendered html element
onkeydown | false |  | true | String | Set the html onkeydown attribute on rendered html element
onkeypress | false |  | true | String | Set the html onkeypress attribute on rendered html element
onkeyup | false |  | true | String | Set the html onkeyup attribute on rendered html element
onmousedown | false |  | true | String | Set the html onmousedown attribute on rendered html element
onmousemove | false |  | true | String | Set the html onmousemove attribute on rendered html element
onmouseout | false |  | true | String | Set the html onmouseout attribute on rendered html element
onmouseover | false |  | true | String | Set the html onmouseover attribute on rendered html element
onmouseup | false |  | true | String | Set the html onmouseup attribute on rendered html element
onselect | false |  | true | String | Set the html onselect attribute on rendered html element
openTemplate | false |  | true | String | Set template to use for opening the rendered html.
required | false | false | true | Boolean | If set to true, the rendered element will indicate that input is required
requiredposition | false |  | true | String | Define required position of required form element (left|right)
rootNode | false |  | true | String | The rootNode property.
showGrid | false | true | true | Boolean | Show grid
showRootGrid | false |  | true | String | The showRootGrid property (default true).
tabindex | false |  | true | String | Set the html tabindex attribute on rendered html element
template | false |  | true | String | The template (other than default) to use for rendering the element
templateCssPath | false | {contextPath}/struts/tree.css. | true | String | Template css path
templateDir | false |  | true | String | The template directory.
theme | false |  | true | String | The theme (other than default) to use for rendering the element
title | false |  | true | String | Set the html title attribute on rendered html element
toggle | false | fade | true | String | The toggle property (either 'explode' or 'fade')
toggleDuration | false | 150 | true | String | Toggle duration in milliseconds
tooltip | false |  | true | String | Set the tooltip of this particular component
tooltipConfig | false |  | true | String | Set the tooltip configuration
treeCollapsedTopic | false |  | true | String | The treeCollapsedTopic property.
treeExpandedTopic | false |  | true | String | The treeExpandedTopic property.
treeSelectedTopic | false |  | true | String | The treeSelectedTopic property
value | false |  | true | String | Preset the value of input element.

## Examples

&lt-- statically --> <s:tree id="..." label="..."> <s:treenode id="..." label="..." /> <s:treenode id="..." label="..."> <s:treenode id="..." label="..." /> <s:treenode id="..." label="..." /> &;lt;/s:treenode> <s:treenode id="..." label="..." /> </s:tree>

<-- dynamically --> <s:tree id="..." rootNode="..." nodeIdProperty="..." nodeTitleProperty="..." childCollectionProperty="..." />