• 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
    • 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
      • Format
      • Description
      • Example
• 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: Stylus Studio GUI Reference

Home > Online Product Documentation > Table of Contents > xsl:with-param

xsl:with-param

Passes a parameter value to a template.

Format

<xsl:with-param 
               

              

                
name = "parameter_name" 
                   
[select = "expression1]"
                   
[expr = "expression2"]>
                   
[parameter_value]
                   

                
              
</xsl:with-param>
               

            

Description

The xsl:with-param instruction passes a parameter value to a template. If the template has no matching xsl:param declaration, the XSLT processor ignores the parameter. The value of parameter_name is a qualified name.

The name attribute is required, and it must be a string. The value of the name attribute is a qualified name.

The value that you pass to a template can be an object of any of the types that are returned by expressions. You can specify the value of the parameter in several ways:

The xsl:with-param element must be a child of xsl:apply-templates or xsl:call-template.

You can specify the xsl:with-param instruction in xsl:call-template and xsl:apply-template instructions.

Example

Suppose you specify the following parameter for a template:

<xsl:template name="Appendix">
               

              

                
<xsl:param name = "heading"> 1. </xsl-param>
                   

                
              
...
               
</xsl:template>
               

            

You can pass another value for this variable as follows:

<xsl:call-template name = "Appendix">
               

              

                
<xsl:with-param name = "heading"> A. </xsl:with-param>
                   

                
              
</xsl:call-template>
               

            

Namespace declaration for W3C XSLT namespace.

xsl:output is an XSLT instruction. In this stylesheet, it specifies that the result document will be in HTML format.

xsl:apply-templates is an XSLT instruction. For each node identified by this instruction's select attribute, the XSLT processor goes to another template in this stylesheet, and performs the actions defined in that template. When done, the processor returns here, and moves to the next line in this template. In this template, the select attribute identifies all book elements in the source document.

xsl:sort is an XSLT instruction. The XSLT processor processes the book nodes in alphabetical order by author.

xsl:template is an XSLT instruction. It contains literal data to be copied to the result document and XSLT instructions to be followed by the XSLT processor. The processor performs these steps for the source nodes identified by the match attribute value. In this template, the match attribute identifies the root node of the source document.

xsl:stylesheet is an XSLT instruction. It must be the root element in a stylesheet in Stylus Studio.