view:relationships

When iterating over a view of some hierarchy, this tag makes a Relationship object available in the page context. This Relationship object can tell a page developer if the currently iterated item is a sibling of, a parent or child of, an ancestor or descendant of any other specified item.

The relationships tag must be used from within an "iterate" tag in the same tag library.

The tag allows the page developer to specify what item it is to check up against, by specifying the name/scope attributes or the node attribute.

Syntax

<view:relationships
   id="..."
   name="..."?
   node="..."?
   property="..."?
   scope="..."?>
   <view:first.../>   <view:last.../>
</view:relationships>

Attributes

id, mandatory, no runtime expressions

The name of the page-context attribute to which the newly created Relationships object will be created.

name

The name of an attribute that contains the item to check for relationships. All scopes are checked when looking for the node; this behavior can be changed by specifying the "scope" attribute

property

Name of the property to get the item to check for relationships.

This attribute can not be used without the the name attribute.

scope

The scope in which to look for the base node.

node

The actual item to check for relationships.

Scripting variable (id)

A scripting variable will be defined using the value of the id attribute as its name. The variable is of type com.escenic.common.util.tree.Relationships.