• Chapter 1: Getting Started with Stylus Studio®
• Chapter 2: Editing and Querying XML
• Chapter 3: Converting Non-XML Files to XML
• Chapter 4: Working with XSLT
  • Getting Started with XSLT
  • Tutorial: Understanding How Templates Work
  • Working with Stylesheets
  • Creating Stylesheets That Generate HTML
  • Specifying Extension Functions in Stylesheets
  • Working with Templates
  • Using Third-Party XSLT Processors
  • Validating Result Documents
  • Post-processing Result Documents
  • Generating Formatting Objects
  • Generating Scalable Vector Graphics
  • Generating Java Code for XSLT
  • XSLT Instructions Quick Reference
    • xsl:apply-imports
    • xsl:apply-templates
    • xsl:attribute
    • xsl:attribute-set
    • xsl:call-template
    • xsl:character-map
    • xsl:choose
    • xsl:comment
    • xsl:copy
    • xsl:copy-of
    • xsl:decimal-format
    • xsl:element
    • xsl:fallback
    • xsl:for-each
      • Format
      • Description
      • Example
    • xsl:for-each-group
    • xsl:function
    • xsl:if
    • xsl:import
    • xsl:import-schema
    • xsl:include
    • xsl:key
    • xsl:message
    • xsl:namespace-alias
    • xsl:number
    • xsl:otherwise
    • xsl:output
    • xsl:output-character
    • xsl:param
    • xsl:preserve-space
    • xsl:processing-instruction
    • xsl:sequence
    • xsl:sort
    • xsl:strip-space
    • xsl:stylesheet
    • xsl:template
    • xsl:text
    • xsl:transform
    • xsl:value-of
    • xsl:variable
    • xsl:when
    • xsl:with-param
• Chapter 5: Creating XSLT Using the XSLT Mapper
• Chapter 6: Debugging Stylesheets
• Chapter 7: Defining XML Schemas
• Chapter 8: Defining Document Type Definitions
• Chapter 9: Writing XPath Expressions
• Chapter 10: Working with XQuery in Stylus Studio
• Chapter 11: Composing Web Service Calls
• Chapter 12: Accessing Relational Data as XML
• Chapter 13: Integrating with Third-Party File Systems
• Chapter 14: Extending Stylus Studio
• Chapter 15: The Stylus Studio Java API
• Chapter 16: Stylus Studio GUI Reference

Home > Online Product Documentation > Table of Contents > xsl:for-each

xsl:for-each

Selects a set of nodes in the source document and instantiates the contained template once for each node in the set.

Format

<xsl:for-each select="pattern">
               
  [<xsl:sort[select="expression"][optional_attribute]/>]
               
  template_body 
               
</xsl:for-each>
               

            

Description

The select attribute is required and the pattern must evaluate to a node set. The XSLT processor instantiates the embedded template with the selected node as the current node and with a list of all selected nodes as the current node list.

By default, the new list of source nodes is processed in document order. However, you can use the xsl:sort instruction to specify that the selected nodes are to be processed in a different order. See xsl:sort.

The xsl:for-each instruction is useful when the result document has a regular, known structure. When you know that you want to instantiate the same template for each node in the current node list, the xsl:for-each instruction eliminates the need to find a template that matches each node.

Example

For example, suppose your source document includes the following XML:

<books>
               
  <author>
               
    <name>Sara Peretsky</name>
               
    <booktitle>Bitter Medicine</booktitle>
               
    <booktitle>Killing Orders</booktitle>
               
  </author>
               
  <author>
               
    <name>Dick Francis</name>
               
    <booktitle>Reflex</booktitle>
               
    <booktitle>Proof</booktitle>
               
    <booktitle>Nerve</booktitle>
               
  </author>
               
</books>
               

            

The following stylesheet creates an HTML document that contains a list of authors. Each author is followed by the titles of the books the author wrote. It does not matter how many authors there are nor how many titles are associated with each author. The stylesheet uses the xsl:for-each instruction to process each author and to process each title associated with each author.

<xsl:stylesheet 
               
   xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
               
<xsl:template match = "/">
               
  <html>
               
    <head><title>Authors and Their Books</title></head>
               
    <body> 
               
      <xsl:for-each select = "books/author">
               
    <p>
               
      <xsl:value-of select = "name"/>
               
    <br>
               
      <xsl:for-each select = "booktitle">
               
      <xsl:value-of select = "."/>
               
    <br>
               
      </xsl:for-each>
               
    </p>
               
      </xsl:for-each>
               
    </body>
               
  </html>
               
</xsl:template>
               
</xsl:stylesheet>
               

            

The result document looks like this:

<html>
               
<head>
               
<title>Authors and Their Books</title>
               
</head>
               
<body>
               
<p>
               
Sara Peretsky<br>
               
Bitter Medicine<br>
               
Killing Orders<br>
               
</p>
               
<p>
               
Dick Francis<br>
               
Reflex<br>
               
Proof<br>
               
Nerve<br>
               
</p>
               
</body>
               
</html>