NodeDescendants

From AlfrescoWiki

Back to Component Library

Contents 1 NodeDescendants 1.1 General Description 1.2 Tag Details 1.3 Custom tag attributes 1.4 Example 1.5 Screenshots

[edit] NodeDescendants

[edit] General Description

The Node Descendants component is responsible for rendering the first few child nodes for the specified node. Each child node is displayed as a link and the number of node links to display is configurable.

[edit] Tag Details

<r:nodeDescendants
 id="<string>"
 rendered="<boolean>"
 styleClass="<string>"
 style="<string>"
 maxChildren="<int>"
 separator="<string>"
 showEllipses="<boolean>"
 action="<string>"
 actionListener="<method-binding>"
 value="<property-binding>" MANDATORY
/>

[edit] Custom tag attributes

style - CSS style applied to the node child links.

styleClass - CSS style class applied to the node child links.

maxChildren - maximum number of child node links to display.

separator - separator string to render between each link. Default is the '|' character.

showEllipses - whether to show a set of ellipses '...' if the max number of child node links to render is reached. The ellipses represents the parent node.

action - command outcome action value to execute when a node link is clicked.

actionListener - command listener method binding to execute when a node link is clicked.

value - the parent node to render the child links for. This should be value-bound to a NodeRef object.

[edit] Example

Example showing the component bound to a NodeRef instance with an actionListener to execute when one is clicked:

<r:nodeDescendants value="#{Bean.nodeRef}" styleClass="child" actionListener="#{Bean.clickChildNode}" />

[edit] Screenshots

Shows the NodeDescendants component in the lower area of the image, it is rendering the child node links for the TimeBox 27 node. The ellipses are shown as the number of child nodes has exceeded the maxChildren attribute.