ON THIS PAGE
xsl:template
Syntax
<xsl:template match="pattern" mode="qualified-name" name="qualified-name priority="integer"> <xsl:param name="qualified-name" select="expression"> ... </xsl:param> ... </xsl:stylesheet>
Description
Declare a template that contains rules to apply
when a specified node is matched. The match
attribute associates the template with an XML element. The match
attribute can also be used to define a template
for a whole branch of an XML document. For example, match="/"
matches the root element of the document. Although the match
and name
attributes
are optional, one of the two attributes must be included in the template
definition.
When templates are applied to a node set using the <xsl:apply-templates>
instruction, they might be
applied in a particular mode; the mode
attribute
in the <xsl:template>
instruction indicates
the mode in which a template needs to be applied for the template
to be used. If templates are applied in the specified mode, the match
attribute is used to determine whether the template
can be used with the particular node. If more than one template matches
a node in the specified mode, the priority attribute determines which
template is used. The highest priority wins. If no priority is specified
explicitly, the priority of a template is determined by the match
attribute.
You can pass template parameters using the <xsl:with-param>
element. To receive a parameter, the template must contain an <xsl:param>
element that declares a parameter of
that name. These parameters are listed before the body of the template,
which is used to process the node and create a result.
Attributes
match | (Optional) XPath expression specifying the nodes to which to
apply the template. If this attribute is omitted, the |
mode | (Optional) Indicate the mode in which a template needs to be applied for the template to be used. |
name | (Optional) Specify
a name for the template. Named templates can be explicitly called
with the |
priority | (Optional) Specify a numeric priority for the template. |