xsl:for-each
Causes iteration over the nodes selected by a node-set expression.
Category: instruction
Content: (
xsl:sort*
, sequence-constructor
)
Permitted parent elements:
any XSLT element whose content model is
sequence-constructor; any literal result element
Attributes
|
|
|
Defines the nodes over which the statement
will iterate. The XSLT statements subordinate to the |
|
|
|
The items
selected by the |
Notes on the Saxon implementation
Saxon-EE offers an extension to the xsl:for-each instruction; the saxon:threads attribute allows the items in the input sequence to be
processed in parallel. This is most likely to be effective when (a) the processing of
each item is expensive, and (b) the output produced by processing each item is small.
Allocating multiple threads when each item generates a new result document is pointless,
because xsl:result-document already runs in a separate thread.
For xsl:for-each to be streamable, the W3C rules require that the
select expression must be "striding", which essentially means
that it may use the child axis but not the descendant axis (to ensure that
selected nodes do not overlap each other). Prior to Saxon 9.5, Saxon attempted
to be more liberal than this, and allow limited streaming also when the
descendant axis was used. Since Saxon 9.6, the implementation has been brought
into line with the W3C specification. In many cases the restriction can be
circumvented by using the outermost function, for example the
expression outermost(//title) is striding even though it uses the
descendant axis.
Details
The xsl:for-each element can be used as an alternative to xsl:apply-templates
where the child nodes of the current node are known in advance.
It may have one or more xsl:sort child elements to define the order of sorting. The sort keys are specified in major-to-minor order. The expression used for sorting can be any string expression. The following are particularly useful:
-
element-name, e.g.
TITLE: sorts on the value of a child element -
attribute-name, e.g.
@CODE: sorts on the value of an attribute -
".": sorts on the character content of the element -
"qname(.)": sorts on the name of the element
Examples
Example 1
<xsl:template match="BOOKLIST"> <TABLE> <xsl:for-each select="BOOK"> <TR> <TD><xsl:value-of select="TITLE"/></TD> <TD><xsl:value-of select="AUTHOR"/></TD> <TD><xsl:value-of select="ISBN"/></TD> </TR> </xsl:for-each> </TABLE> </xsl:template>Example 2
Sorting with xsl:for-each. This example shows a template for a
<BOOKLIST> element which processes all the child
<BOOK> elements in order of their child
<AUTHOR> elements.