Returns all predecessors of the given element.
That is the chain of elements by which the given element has been reached as it was retrieved from the data source (DSM) through the interpretation of some Location Path/Rules. See also "What are element predecessors?" below.
Precisely, this property returns an array produced from the given element as the following:
{ predecessor,
predecessor->predecessor,
predecessor->predecessor->predecessor,
... }
The sequence repeats until reaching null
.
If the element was not originated from processing of an Element Iterator or a Location Path, this property returns an empty array.
As example, let's assume an Element Iterator was specified to iterate
by descendants of the received context element.
Then, each element from the iteration scope will have the predecessors
property
assigned with the chain of all the element's ancestors until the iterator's context element,
that context element itself plus all its own predecessors.
${include ../../refs/element_predecessors.htm}